List the FurniOps taxonomy
Every category of the FurniOps taxonomy in one list, parents before their children and siblings in display order. Each names the GS1 GPC class it falls under.
- Scopes
sources:read - Rate classread
/v1/categoriesEvery category of the FurniOps taxonomy in one list, parents before their children and siblings in display order. Each names the GS1 GPC class it falls under.
Authorization
apiKey An API key (fo_live_… / fo_test_…) as a bearer token
In: header
Header Parameters
Dated API version; pinned per organisation on first use and overridable per request
Value in
- "2026-10-01"
- "2026-10-04"
The data the request acts on: test is the organisation's sandbox. An OAuth token picks it (live by default); an API key's mode is fixed, and naming the other one is refused
Value in
- "live"
- "test"
ETag of a cached representation; a match returns 304
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/categories"{ "object": "list", "data": [ { "object": "category", "id": "string", "parent": "string", "name": "string", "slug": "string", "path": "string", "gpc_class": "string" } ], "has_more": true, "next_cursor": "string"}List a source's mappings GET
The source's mappings, one per header set its files have had, newest first. A run that stopped as `needs_mapping` waits for its `proposed` one.
List a source's categories GET
Every category path the source's current products name, and every path above them, in path order: how many products sit at or below each, the rule set there, the rule inherited from above, or a same-name suggestion. Products under a path with no rule have no category.