List products
Returns the products of a specific catalog with cursor-based pagination.
Endpoint: GET /v1/catalogs/{did}/products
Parameters
Path
| Parameter | Type | Required | Description |
|---|---|---|---|
did | string | Yes | Target ID. |
Query
| Parameter | Type | Required | Description |
|---|---|---|---|
catalog_id | string | Yes | Catalog ID. |
cursor | string | No | Pagination cursor. |
limit | number | No | Results per page. |
client_id | number | No | Client. Requires BSP_CN if it differs from the token. |
Request
curl --request GET \
--url 'https://api.chattigo.com/v1/catalogs/{did}/products?catalog_id=1234567890&limit=20' \
--header 'Authorization: Bearer <token>'Response
Success (200)
{
"data": [
{
"id": "sku123",
"name": "Running shoe",
"retailer_id": "SKU-1",
"image_urls": ["https://..."],
"description": "Black running shoe",
"currency": "USD",
"price": "59.99",
"url": "https://...",
"category": "apparel",
"unique_id": "prod_1"
}
],
"paging": {
"cursors": {
"before": "QVFIU...",
"after": "Q2F0YWxvZ3M..."
}
}
}Errors
| Code | Case |
|---|---|
400 | did is required, catalog_id is required, or invalid client_id |
403 | DID outside the WABA hierarchy, or access to another client without BSP_CN |
502 | BSP config resolution failed (upstream service unavailable) |