Method list

Test your request

Changelog

Returns listing queue rows created by a Listing Agent with their status and errors, e.g. offers rejected by the marketplace. Works also for agents deleted in the last 14 days. Rows created before 2026-09-24 are not assigned to agents.

listing_agent_id	int	Listing Agent identifier.
filter_status_group	varchar(20)	in_progress (waiting, preparing, sending, verification), draft (saved as a draft, waiting for approval), error (rejected by validation or by the marketplace) or listed (offer created). Omit to return all.
filter_product_id	varchar(255)	Return rows of one product (product ID in the agent source of products).
page	int	Results page (100 rows per page, numbered from 1).

The method returns the data in JSON format.

status	varchar(30)	SUCCESS - request executed correctly ERROR - an error occurred during an API request. Error details will be described in 2 additional returned fields: error_message and error_code
page	int	The one-based page number returned.
marketplace_code	varchar(50)	Marketplace code of the agent.
queue_items	array	Rows ordered by queue_id descending. Rows being deleted or deleted are not returned.
| - queue_id	int	Listing queue row ID.
| - product_id	varchar(255)	Product ID in the agent source of products.
| - variant_id	varchar(255)	Variant ID. Empty – not a variant.
| - site	varchar(10)	Marketplace site. Empty for marketplaces without sites.
| - status_group	varchar(20)	in_progress, draft, error or listed.
| - status	int	Detailed queue status of the marketplace integration (values differ between Amazon and other marketplaces).
| - errors	text	Errors of the row (plain text, up to 1000 characters), e.g. returned by the marketplace or autosell_dispatch_timeout when the row was not sent within 3 hours.
| - date_added	int	Unix timestamp when the row was added to the queue.

Input data:
{ "listing_agent_id": 4812, "filter_status_group": "error" } Output data:
{ "status": "SUCCESS", "page": 1, "marketplace_code": "allegro", "queue_items": [ { "queue_id": 5521907, "product_id": "88240", "variant_id": "", "site": "", "status_group": "error", "status": 9, "errors": "Missing GPSR: responsible producer", "date_added": 1792396500 } ] } A sample request in PHP:
<?php $methodParams = '{ "listing_agent_id": 4812, "filter_status_group": "error" }'; $apiParams = [ "method" => "getListingAgentQueueItems", "parameters" => $methodParams ]; $curl = curl_init("https://api.base.com/connector.php"); curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_HTTPHEADER, ["X-BLToken: xxx"]); curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($apiParams)); $response = curl_exec($curl);