Taxonomy
Versioned global taxonomy. Filter direct children with parent or eligible candidate leaves with a service slug in scope. Unknown or inactive parents return 404. Revalidate with the ETag; a conditional request returns 304 when unchanged.
Authorization
clientKey The store's API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
In: header
Query Parameters
length <= 64Value in
- "pharmacy"
- "foods"
- "boli"
- "suya"
- "shawarma-pizza-snacks"
- "local-meals"
- "fruits-fresh-natural"
- "laundry"
- "supermarket"
- "groceries"
- "meat-fish"
- "gas-refill"
- "local-market"
- "fashion"
- "beauty-cosmetics"
- "electronics"
- "phones-accessories"
- "home-living"
- "baby-kids"
- "health-wellness-store"
- "office-school"
Header Parameters
Your store API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/store/taxonomy?scope=foods" \ -H "X-Client-Key: {{clientKey}}"{ "status": "success", "message": "Taxonomy retrieved", "data": [ { "id": "ap-2-1", "parent_id": "ap-2", "name": "Bird Supplies", "slug": "bird-supplies", "level": 2, "vertical": "ap", "is_leaf": true } ], "version": "2026-08+qk-1"}Retrieve an active taxonomy node by string id or slug, with its active ancestors and children. Accepted, inactive and unknown nodes answer 404.
Authorization
clientKey The store's API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
In: header
Path Parameters
Header Parameters
Your store API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/store/taxonomy/ap-2-1" \ -H "X-Client-Key: {{clientKey}}"{ "status": "success", "message": "Taxonomy node retrieved", "data": { "id": "aa-1", "parent_id": "aa", "name": "Clothing", "slug": "clothing", "level": 1, "vertical": "aa", "is_leaf": false, "ancestors": [ { "id": "aa", "name": "Fashion", "slug": "fashion" } ], "children": [ { "id": "aa-1-1", "parent_id": "aa-1", "name": "Activewear", "slug": "activewear", "level": 2, "vertical": "aa", "is_leaf": true }, { "id": "aa-1-25", "parent_id": "aa-1", "name": "Kids' Clothing", "slug": "kids-clothing", "level": 2, "vertical": "aa", "is_leaf": false }, { "id": "aa-1-13", "parent_id": "aa-1", "name": "Clothing Tops", "slug": "clothing-tops", "level": 2, "vertical": "aa", "is_leaf": false }, { "id": "aa-1-4", "parent_id": "aa-1", "name": "Dresses", "slug": "dresses", "level": 2, "vertical": "aa", "is_leaf": true }, { "id": "aa-1-6", "parent_id": "aa-1", "name": "Lingerie", "slug": "lingerie", "level": 2, "vertical": "aa", "is_leaf": true }, { "id": "aa-1-7", "parent_id": "aa-1", "name": "Maternity Clothing", "slug": "maternity-clothing", "level": 2, "vertical": "aa", "is_leaf": true }, { "id": "aa-1-8", "parent_id": "aa-1", "name": "Men's Undergarments", "slug": "mens-undergarments", "level": 2, "vertical": "aa", "is_leaf": false }, { "id": "aa-1-9", "parent_id": "aa-1", "name": "One-Pieces", "slug": "one-pieces", "level": 2, "vertical": "aa", "is_leaf": true }, { "id": "aa-1-10", "parent_id": "aa-1", "name": "Outerwear", "slug": "outerwear", "level": 2, "vertical": "aa", "is_leaf": false }, { "id": "aa-1-11", "parent_id": "aa-1", "name": "Outfit Sets", "slug": "outfit-sets", "level": 2, "vertical": "aa", "is_leaf": true }, { "id": "aa-1-12", "parent_id": "aa-1", "name": "Pants", "slug": "pants", "level": 2, "vertical": "aa", "is_leaf": false }, { "id": "aa-1-14", "parent_id": "aa-1", "name": "Shorts", "slug": "shorts", "level": 2, "vertical": "aa", "is_leaf": true }, { "id": "aa-1-15", "parent_id": "aa-1", "name": "Skirts", "slug": "skirts", "level": 2, "vertical": "aa", "is_leaf": true }, { "id": "aa-1-16", "parent_id": "aa-1", "name": "Skorts", "slug": "skorts", "level": 2, "vertical": "aa", "is_leaf": true }, { "id": "aa-1-17", "parent_id": "aa-1", "name": "Sleepwear & Loungewear", "slug": "sleepwear-loungewear", "level": 2, "vertical": "aa", "is_leaf": true }, { "id": "aa-1-18", "parent_id": "aa-1", "name": "Socks", "slug": "socks", "level": 2, "vertical": "aa", "is_leaf": true }, { "id": "aa-1-19", "parent_id": "aa-1", "name": "Suits", "slug": "suits", "level": 2, "vertical": "aa", "is_leaf": false }, { "id": "aa-1-20", "parent_id": "aa-1", "name": "Swimwear", "slug": "swimwear", "level": 2, "vertical": "aa", "is_leaf": true }, { "id": "aa-1-23", "parent_id": "aa-1", "name": "Native Wear", "slug": "native-wear", "level": 2, "vertical": "aa", "is_leaf": false }, { "id": "aa-1-24", "parent_id": "aa-1", "name": "Uniforms & Workwear", "slug": "uniforms-workwear", "level": 2, "vertical": "aa", "is_leaf": false }, { "id": "aa-1-22", "parent_id": "aa-1", "name": "Wedding & Bridal Party Dresses", "slug": "wedding-bridal-party-dresses", "level": 2, "vertical": "aa", "is_leaf": true } ] }, "version": "2026-08+qk-1"}