List jobs
Lists the account jobs, one page at a time.
Returns the jobs of your account, from the newest to the oldest. Filter by status and by type.
curl "$BACKEND_URL/v1/jobs?status=running&type=connection.sync&page=1&pageSize=20" \
-H "Authorization: Bearer mk_your_api_key"A new job pushes the older ones to the next page. When walking pages, deduplicate on id. To wait for one job, prefer Get a job or the job events (job.completed, job.partially_completed, job.failed).
api_keyAuthorizationBearer <token>API key (mk_...)
page?integerPage number, starting at 1. Defaults to 1. A page beyond pagination.totalPages is not an error: it returns empty data.
1 <= value <= 90071992547409911pageSize?integerItems per page, from 1 to 100. Defaults to 20.
1 <= value <= 10020status?stringOnly jobs in this state.
"queued""running""completed""partial""failed"type?stringOnly jobs of this type.
"connection.sync""listing.publish""listing.remove""listing.import""listing.reconcile""inventory.publish""marketplace_product.publish""order.import""order.reconcile"One page of the account jobs, newest first. Internal jobs (our own maintenance) are not listed. A page beyond pagination.totalPages returns empty data, not 404.
application/json- response
One page of jobs.
data*array<>The jobs of this page, newest first.
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"{ "data": [ { "id": "7c6b5a49-3827-4615-a0b9-c8d7e6f5a4b3", "sellerId": "3d1c8a52-7f0e-4b0a-8a65-9c1b2f6d7e01", "type": "connection.sync", "status": "completed", "total": 1, "processed": 1, "succeeded": 1, "failed": 0, "input": { "connectionId": "9a1b2c3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d" }, "result": null, "error": null, "startedAt": "2026-10-06T14:32:01.000Z", "finishedAt": "2026-10-06T14:32:01.500Z", "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 }}