List catalogs
curl --request GET \
--url https://app.alana.shopping/api/workspace/{workspaceId}/catalogs \
--header 'Authorization: Bearer <token>'{
"data": [
{
"id": "catalog_1a2b3c",
"workspace_id": "ws_1a2b3c4d",
"name": "Q1 2024 Catalog",
"description": "Spring product lineup",
"status": "published",
"product_count": 250,
"feed_ready_count": 180,
"avg_optimization_score": 82.5,
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-02-10T14:22:00Z"
}
],
"pagination": {
"limit": 50,
"has_more": false
}
}List Catalogs
Retrieve catalogs with product and optimization statistics
GET
/
api
/
workspace
/
{workspaceId}
/
catalogs
List catalogs
curl --request GET \
--url https://app.alana.shopping/api/workspace/{workspaceId}/catalogs \
--header 'Authorization: Bearer <token>'{
"data": [
{
"id": "catalog_1a2b3c",
"workspace_id": "ws_1a2b3c4d",
"name": "Q1 2024 Catalog",
"description": "Spring product lineup",
"status": "published",
"product_count": 250,
"feed_ready_count": 180,
"avg_optimization_score": 82.5,
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-02-10T14:22:00Z"
}
],
"pagination": {
"limit": 50,
"has_more": false
}
}Authorizations
Bearer token authentication via Auth0. Users authenticate through Auth0 Universal Login. Include the access token in the Authorization header: Authorization: Bearer <token>
Headers
Active brand ID. Used as default brand filter when brand_id query param is absent.
Path Parameters
The workspace ID
Pattern:
^ws_[a-z0-9]+$Query Parameters
Required range:
1 <= x <= 100Filter catalogs by brand ID. When absent for admin/owner, returns all brands grouped.
Last modified on February 16, 2026
⌘I