GET categories/get

GET /api/v2/categories/get

Returns product categories (product groups). Can return the global list, categories scoped to an event, a single category by ID, or categories updated after a timestamp.


Authentication

Authorization: Bearer <your_api_key>

Endpoint

GET /api/v2/categories/get

Query Parameters

Parameter

Type

Required

Description

id

integer

No

Returns a single category by ID. Takes priority over other filters

event_id

integer

No

Filters to categories associated with this event

timestamp

integer

No

Returns only categories updated after this Unix timestamp


Response Fields

Field

Type

Description

id

integer

Product group ID — use this in POST /api/v2/product/set

name

string

Category display name

parent_id

integer

Parent category ID. 0 = top-level category


Example Requests

Bash
# All categories (global)
curl -X GET "https://your-event-domain.com/api/v2/categories/get" \
  -H "Authorization: Bearer your_api_key_here"

# Event-scoped
curl -X GET "https://your-event-domain.com/api/v2/categories/get?event_id=7" \
  -H "Authorization: Bearer your_api_key_here"