Skip to main content
GET
List submissions

Authorizations

X-API-Key
string
header
required

API key issued by the Taste Engine. Create one in the dashboard at https://engine.tastelabs.com/app/api-keys.

Query Parameters

status
enum<string>

Filter results to a single status. Lifecycle status of a submission.

Available options:
accepted,
queued,
crawling,
extracting,
completed,
failed
q
string

Free-text search over the source URL. Returns only submissions whose URL contains this substring (case-insensitive).

api_key_id
string

Return only submissions created with this API key.

batch_id
string

Return only submissions from this batch run.

limit
integer
default:50

Maximum number of submissions to return.

Required range: 1 <= x <= 100
offset
integer
default:0

Number of submissions to skip, for pagination.

Required range: x >= 0

Response

A page of submissions.

submissions
object[]
required
total
integer
required

Total submissions matching the filter.

limit
integer
required
offset
integer
required
totals
object

Counts by outcome across everything matching the filter, ignoring pagination. The four in-progress statuses fold into in_progress, so the three buckets sum to total.