Skip to content
docs
ES
CatalogChannels

List the batches of channel price and stock values

Returns the channel's price and stock batches, newest first, with who made them and whether they were undone.

GET/v1/channels/{channelId}/variant-settings/batches
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"

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/variant-settings/batches" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>"
{  "data": [    {      "batchId": "7204558912004329434",      "origin": "list",      "actorName": "Polo de algodón Azul / M",      "createdOn": "2026-09-28T15:30:00Z",      "variants": 1,      "undoneOn": "2026-09-28T15:30:00Z",      "undoBatchId": "7204558912004322102"    }  ],  "hasNextPage": true,  "nextCursor": "eyJpZCI6IjcyMDQ1NTg5MTIwMDQzMjUzMDEifQ",  "totalCount": 24}