Hivebuy External API (v2)

Sections

Theme switcher

List purchase orders

Header Parameters

Authorizationstring

Query Parameters

pageinteger

Page number, starting at 1.

Minimum
1
Default value
1
pageSizeinteger

Rows per page. Default 10, maximum 30.

Maximum
30
Default value
10
statusstring

Narrow by order status. Repeat the key or send a comma list for several. An unknown value is a 400 listing the valid ones. Codes: O Ordered, R Rejected, P Pending, I Invoiced, S Sent, RT Resent, PA Partial, RS Resolved, D Delivered, CO Completed, CA Canceled, ID In delivery, OH On hold, RE Returned.

Enum values:
ORPISRTPARSDCO
... 4 other enums
orderstring

Order number. Non-digits are stripped, so the display form works; a value with no digits at all is a 400.

createdBystring

Email of the requester. Must be a valid address.

updatedAtFromstring

Orders updated at or after this ISO-8601 timestamp. See the section page: nested changes do not bump this field.

updatedAtTostring

Orders updated at or before this timestamp.

orderingstring

Sort key, - for descending. Default -orderNumber. A stable id tiebreaker is always appended so paging cannot repeat or skip a row.

Enum values:
createdAt-createdAtupdatedAt-updatedAtorderNumber-orderNumberstatus-status

Path Parameters

companyIdstring Required

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

Response

200
Object

The standard paginated envelope.

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. 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