Sample - Box Platform API
GET/enterprises/{enterprise_id}/device_pinners

List enterprise device pins

Retrieves all the device pins within an enterprise.

The user must have admin privileges, and the application needs the "manage enterprise" scope to make this call.

4 parameters
enterprise_idstringrequired
The ID of the enterprise.
markerstringoptional
Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires `usemarker` to be set to `true`.
limitintegeroptional
The maximum number of items to return per page.
directionstringoptional
The direction to sort results in. This can be either in alphabetical ascending (`ASC`) or descending (`DESC`) order.
Allowed:ASCDESC

2 status codes
200Returns a list of device pins for a given enterprise.
entriesarray<DevicePinner>optional
A list of device pins.
limitintegeroptional
The limit that was used for these entries. This will be the same as the `limit` query parameter unless that value exceeded the maximum value allowed.
Default:100
next_markerintegeroptional
The marker for the start of the next page of results.
orderarray<object>optional
The order by which items are returned.
defaultAn unexpected client error.
typestringoptional
The value will always be `error`.
Allowed:error
statusintegeroptional
The HTTP status of the response.
codestringoptional
A Box-specific error code.
Allowed:createdacceptedno_contentredirectnot_modifiedbad_requestunauthorizedforbiddennot_foundmethod_not_allowedconflictprecondition_failed
messagestringoptional
A short message describing the error.
context_infoobjectoptional
A free-form object that contains additional context about the error. The possible fields are defined on a per-endpoint basis. `message` is only one example.
help_urlstringoptional
A URL that links to more information about why this error occurred.
request_idstringoptional
A unique identifier for this response, which can be used when contacting Box support.

Error handling

Any other status is an error: An unexpected client error.