Skip to content
docs
Guides
ES
CatalogAgent Read
channel:read

List sales channel listings for agent tools

GET/v1/agent-read/channels/{channelId}/listings

List sales channel listings for agent tools. A successful request returns HTTP 200 with the documented response body.

Authorization

bearerAuth
AuthorizationBearer <token>

OAuth2 access token issued by Ecomiq Auth.

In: header

Path Parameters

channelId*string

Identifier of the sales channel.

Query Parameters

limit?integer

Maximum number of results to return.

Formatint32
cursor?string

Opaque cursor from the previous response. Omit it on the first page.

Header Parameters

x-Store-Id?string

Store the request acts on. Not needed when the token is bound to a store.

Authorization*string

OAuth 2.0 bearer token.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/agent-read/channels/7204558912004325301/listings" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>"
{  "items": [    {      "id": "7204558912004325301",      "productId": "7204558912004325301",      "type": "salesChannel",      "ownerId": "7204558912004325301",      "status": "example",      "readinessStatus": "example",      "price": 1,      "externalId": "7204558912004325301",      "externalSku": "SKU-001",      "externalUrl": "https://example.com/resource",      "lastSyncAt": "2026-08-01T15:30:00Z",      "hasError": false,      "issues": [        {          "code": "example_code",          "message": "example",          "blocking": false        }      ]    }  ],  "hasNextPage": false,  "nextCursor": "example"}