Hivebuy External API (v2)

Sections

Theme switcher

List custom fields

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
isActiveboolean

true or false (also 1/0). Anything else is a 400.

appliesTostring

Narrow to fields asked per item or per request. An unknown value is a 400 listing the valid ones.

Enum values:
ITEMREQUEST
typestring

Narrow by field type. An unknown value is a 400 listing the valid ones.

Enum values:
BOOLEANTEXTPRICESELECTDATE
orderingstring

Sort key, prefixed with - for descending. Default order, the position in the form, which is also what the in-app endpoint returns. createdAt sorts on the creation time even though the shape does not expose it. An unknown key is a 400 listing the valid ones. A stable -id tiebreaker is always appended, so paging cannot repeat or skip a row.

Default value
order
Enum values:
order-ordername-namecreatedAt-createdAt
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 custom-field definitions.

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

A query parameter was invalid or unknown. attr names it.

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