Skip to main content
GET
/
enterprises
/
{enterprise_id}
/
device_pinners
cURL
curl -i -X GET "https://api.box.com/2.0/enterprises/3442311/device_pinners" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
{
  "entries": [
    {
      "id": "11446498",
      "type": "device_pinner",
      "owned_by": {
        "id": "11446498",
        "type": "user",
        "name": "Aaron Levie",
        "login": "[email protected]"
      },
      "product_name": "iPad"
    }
  ],
  "limit": 200,
  "next_marker": 3000,
  "order": [
    {
      "by": "id",
      "direction": "asc"
    }
  ]
}
This endpoint is in the version 2024.0. No changes are required to continue using it. For more details, see Box API versioning.Learn more about Box SDK versioning strategy.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
enterprise_id
string
required

The ID of the enterprise.

Query Parameters

​
marker
string

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.

​
limit
integer<int64>

The maximum number of items to return per page.

Required range: x <= 1000
​
direction
enum<string>

The direction to sort results in. This can be either in alphabetical ascending (ASC) or descending (DESC) order.

Available options:
ASC,
DESC

Response

Returns a list of device pins for a given enterprise.

A list of device pins.

​
entries
Device pinner · object[]

A list of device pins.

​
limit
integer<int64>
default:100

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.

Example:

200

​
next_marker
integer<int64>

The marker for the start of the next page of results.

Example:

3000

​
order
object[]

The order by which items are returned.