Skip to main content
GET
/
v1
/
taxonomy
Get a list of taxonomies
curl --request GET \
  --url https://app.variable.global/api/v1/taxonomy \
  --header 'Authorization: Bearer <token>'
[
  {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "Electricity",
    "slug": "electricity",
    "path": "energy/electricity"
  }
]
Requires permission:

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
q
string

Search by name or path (case-insensitive)

​
path
string

Filter to categories under this path prefix

​
depth
integer

Filter by tree depth (0 = top-level roots, 1 = their direct children, etc.)

​
leaves_only
boolean

If true, return only leaf categories (ones with no children)

​
page
integer

Page number (1-based)

​
limit
integer

Results per page

Response

A list of taxonomies

​
uuid
string<uuid>
​
name
string
Example:

"Electricity"

​
slug
string
Example:

"electricity"

​
path
string
Example:

"energy/electricity"