API ReferenceListings
List listings
GET /rest/v1/listings
The query surface for everything channel-side. ?status=error returns every failing listing; add error_code to target one specific failure (the exact filter your retry runs should use).
Authorization
apiKey AuthorizationBearer <token>
Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.
In: header
Query Parameters
limit?integer
Range
1 <= value <= 100Default
25cursor?string
product_id?string
channel_account_id?string
channel?string
Base channel filter (e.g. ebay matches every eBay account).
status?string
New values may be added; tolerate unknowns.
Value in
- "listed"
- "imported"
- "ongoing"
- "error"
- "delisted"
error_code?string
Only listings whose issues[] contain this code.
updated_after?string
Format
date-timeResponse Body
application/json
application/json
curl -X GET "https://example.com/listings"{ "object": "list", "has_more": true, "next_cursor": "string", "data": [ { "id": "list_9ac2e", "object": "listing", "product_id": "string", "channel_account_id": "string", "channel": "string", "status": "listed", "id_on_channel": "string", "url_on_channel": "http://example.com", "site": "string", "overrides": { "title": "string", "description": "string", "category_id": "string" }, "attributes": {}, "variants": [ { "variant_id": "var_66a1f1", "sku": "string", "id_on_channel": "string", "status": "string" } ], "issues": [ { "code": "photo_required_for_channel", "severity": "error", "message": "string", "attribute_names": [ "string" ] } ], "operation_id": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ]}Last updated on July 28, 2026
Need help?
The API is in private beta — email us and a human replies, usually within one business day.