List merchant categories

Merchant Categories

Description

Retrieve paginated merchant activity categories from the category table.

Merchant activity_types must use assignable category path values returned by this endpoint.

Authentication Required: User must be authenticated and have the 'merchant' feature flag.

page integer query

Page number for pagination

query string query

Case-insensitive search against the localized category name. Ignored when `ids` is provided.

ids string query

Comma-separated category IDs to return

Accept-Language string header

Locale used for the returned category name

200 Successful response

application/json

statusstring

Example: success

dataarray

current_pageinteger

Example: 1

total_resultsinteger

Example: 10

total_pagesinteger

Example: 1

401 Authentication required

application/json

Example:

{
  "status": "error",
  "message": "Not authenticated or insufficient permissions"
}

403 Insufficient permissions - user must be merchant

application/json

Example:

{
  "status": "error",
  "message": "Feature merchant required"
}