Skip to main content
GET
List themes

Authorizations

Authorization
string
header
required

A workspace API key.

Query Parameters

parentId
string

Return only this theme’s direct children. Use an id from GET /v1/themes → themes[].id.

Required string length: 1 - 160
Example:

"iab:3.1:391"

rootOnly
boolean
default:false

Top-level themes only. Mutually useful with parentId, not with it.

q
string

Free-text search over theme names.

Required string length: 1 - 200
Example:

"personal finance"

limit
integer
default:100

How many themes to return. Between 1 and 200; defaults to 100.

Required range: 1 <= x <= 200
cursor
string

The nextCursor from a previous page. Omit for the first page.

Required string length: 1 - 500

Response

Success.

success
boolean
required
themes
object[]
required

This page of canonical themes.

hasMore
boolean
required

True when another page exists.

nextCursor
string | null
required

Pass this opaque value as cursor for the next page; null means this is the last page.

taxonomy
object
required

Taxonomy identity and reproducibility metadata.

{key}
any