Skip to content
docs
ES
CatalogChannels

List channel listings

Returns cursor-paginated listings, filterable by status, readiness, category, price and stock.

GET/v1/channels/{channelId}/listings
Requires an access token with the channel:read permission.

Path Parameters

channelId*string

Identifier of the sales channel.

Query Parameters

limit?integer

Maximum number of results to return.

Formatint32
cursor?string

Cursor from the previous response. Omit it on the first page.

search?string

Free-text search.

sortBy?string

Field to sort by.

sortDirection?string

Sort direction: asc or desc.

Value in

  • "asc"
  • "desc"
status?array<>

Only items in these statuses.

Value in

  • "draft"
  • "publishing"
  • "active"
  • "failed"
  • "unpublished"
  • "suspended"
  • "syncError"
  • "needsAttention"
readiness?array<>

Value in

  • "unknown"
  • "ready"
  • "notReady"
state?array<>

Only items in these states.

Value in

  • "published"
  • "sending"
  • "notPublished"
  • "needsData"
  • "withWarnings"
  • "error"
  • "pausedByChannel"
  • "pausedByStock"
  • "paused"
categoryIds?array<ResourceId>

Only items in these categories.

gender?array<string>

Gender the item is intended for.

minPrice?number

Lowest price to include, in the store currency.

Formatdouble
maxPrice?number

Highest price to include, in the store currency.

Formatdouble
minStock?integer

Minimum stock level.

Formatint32
maxStock?integer

Maximum stock level.

Formatint32
issues?boolean
listingType?string

Value in

  • "salesChannel"
  • "source"
categorySource?array<>

Value in

  • "override"
  • "mapping"
  • "provisional"
includeTotalCount?boolean

Include the total number of matches. Slower on large catalogs.

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://api.ecomiq.pe/api/v1/channels/7204558912004329619/listings" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>"
{  "data": [    {      "id": "7204558912004329619",      "channelId": "7204558912004329619",      "productId": "7204558912004322039",      "listingType": "salesChannel",      "externalId": "7204558912004323067",      "externalUrl": "https://mi-tienda.ecomiq.app/products/polo-de-algodon",      "status": "draft",      "price": 89,      "compareAtPrice": 99,      "lastSyncAt": "2026-09-28T15:30:00Z",      "lastSyncError": "Tienda online",      "lastSyncErrorCode": "POL-001",      "readinessStatus": "ready",      "readinessIssues": [        {          "code": "POL-001",          "message": "Entregar después de las 18:00.",          "blocking": false,          "source": "Tienda online",          "references": [            "Mi tienda"          ],          "causeCode": 1,          "sku": "POL-001-AZ-M",          "attributeId": "7204558912004325220"        }      ],      "publishable": false,      "readinessUpdatedAt": "2026-09-28T15:30:00Z",      "createdOn": "2026-09-28T15:30:00Z",      "updatedOn": "2026-09-28T15:30:00Z"    }  ],  "hasNextPage": true,  "nextCursor": "eyJpZCI6IjcyMDQ1NTg5MTIwMDQzMjUzMDEifQ",  "totalCount": 24}