Collections

Visibility

GET /collections — Public
GET /collections/{slug} — Public

Authentication

x-api-key: sk_eco_...

`GET /collections`

Returns paginated active collections.

Query Parameters

Param	Type	Description
`limit`	`number`	Page size
`offset`	`number`	Pagination offset

`GET /collections/{slug}`

Returns one collection with paginated products.

Query Parameters

Param	Type	Description
`limit`	`number`	Product page size
`offset`	`number`	Product page offset

Response Shape

Field	Type
`collection`	`CollectionResponse`
`products`	`ProductResponse[]`
`pagination`	`PaginationMeta`

cURL

curl -X GET "https://api.ecommaps.com/api/v1/storefront/collections" \
  -H "x-api-key: sk_eco_YOUR_KEY"
 
curl -X GET "https://api.ecommaps.com/api/v1/storefront/collections/menswear" \
  -H "x-api-key: sk_eco_YOUR_KEY"

SDK Example

const collections = await ecommapsClient.collections.list();
const collection = await ecommapsClient.collections.retrieve("menswear", 20, 0);

Error Matrix

Status	Scenario
`401`	Missing/invalid API key
`404`	Collection slug not found
`500`	Datastore/query failure

Products, Search & Categories Cart