Jobs

List items

Lists the items of a job, in the job order.

GET
/v1/jobs/{id}/items

Returns the items of a job in its order (index ascending), with the outcome and the error of each one.

curl "$BACKEND_URL/v1/jobs/<id>/items?status=failed&page=1&pageSize=100" \
  -H "Authorization: Bearer mk_your_api_key"

Items are fixed when the job is created, so unfiltered pages stay stable while the job runs. With status, an item moves to another page when it finishes (pending → succeeded): filter after the job is done.

Authorization

api_key
headerAuthorizationBearer <token>

API key (mk_...)

Path Parameters

id*string

Identifier of the resource, as returned by the API.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Query Parameters

page?integer

Page number, starting at 1. Defaults to 1. A page beyond pagination.totalPages is not an error: it returns empty data.

Range1 <= value <= 9007199254740991
Default1
pageSize?integer

Items per page, from 1 to 100. Defaults to 20.

Range1 <= value <= 100
Default20
status?string

Only items in this state.

Value in"pending""succeeded""failed"

Response Body

One page of the job items, in the job order (index, ascending). A page beyond pagination.totalPages returns empty data, not 404.

application/json
  1. response

One page of the items of a job.

data*array<>

The items of this page, in the job order (index, ascending).

pagination*

Where this page sits in the whole listing: the totals and whether there are pages before and after it.

curl -X GET "https://example.com/v1/jobs/3d1c8a52-7f0e-4b0a-8a65-9c1b2f6d7e01/items"
{  "data": [    {      "id": "b4a39281-7065-4f43-9e21-0d1c2b3a4f5e",      "index": 0,      "status": "succeeded",      "input": {},      "result": {        "connectionId": "9a1b2c3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d",        "marketplace": "mercadolivre",        "synced": []      },      "error": null,      "resourceType": "connection",      "resourceId": "9a1b2c3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d",      "createdAt": "2026-10-06T14:32:00.000Z",      "updatedAt": "2026-10-06T14:32:01.500Z"    }  ],  "pagination": {    "page": 1,    "pageSize": 20,    "totalItems": 1,    "totalPages": 1,    "hasNext": false,    "hasPrev": false  }}