Hivebuy External API (v2)

Sections

Theme switcher

List catalogues

Header Parameters

Authorizationstring

Query Parameters

pageinteger

Page number, starting at 1.

Minimum
1
Default value
1
pageSizeinteger

Results per page. Default 25, maximum 100.

Minimum
1
Maximum
100
Default value
25
orderingstring

Sort key, prefixed with - for descending. Default name. Name ordering is case-insensitive. It sorts on the English value of names, whatever the key's language. An unknown key is a 400 listing the valid ones, never a silent fallback. A stable -id tiebreaker is always appended, so paging cannot repeat or skip a row.

Default value
name
Enum values:
createdAt-createdAtname-name
fieldsstring

Comma-separated allow-list of top-level fields to return, e.g. ?fields=id,name. Narrows the response only; it cannot widen it, and ?expand= does nothing on this API.

omitstring

Comma-separated list of top-level fields to leave out, e.g. ?omit=children.

Path Parameters

companyIdstring Required

Company ID. Must be one of the IDs returned by GET /api/v2/companies/.

Response

200
Object

Paginated list of catalogues.

Response Attributes

totalRecordsinteger

Total matching records across all pages.

totalPagesinteger

Total pages. 0 when there are no results.

currentPageinteger

The page this response contains.

resultsarray

Show child attributes

400
Object

Invalid query parameter, e.g. an unknown ordering key.

Response Attributes

typestring
Enum values:
validationErrorclientErrorserverError
errorsarray

Show child attributes

401
Object

Missing, invalid, or expired API key, or a session credential was used instead of an API key.

Response Attributes

typestring
Enum values:
validationErrorclientErrorserverError
errorsarray

Show child attributes

403
Object

Authenticated but not entitled: the key's user is not an active member of this company, the External API feature (or the resource's own feature) is not enabled for it, the key lacks the scope this verb needs, or a browser session was used.

Response Attributes

typestring
Enum values:
validationErrorclientErrorserverError
errorsarray

Show child attributes

429
Object

Rate limit exceeded (60 requests per minute per API key). Retry after the number of seconds given in the message.

Response Attributes

typestring
Enum values:
validationErrorclientErrorserverError
errorsarray

Show child attributes

GET

/

Select
1

Response