---
title: "List enterprise device pins"
method: GET
path: "/enterprises/{enterprise_id}/device_pinners"
tags: ["Device pinners"]
---

# List enterprise device pins

`GET /enterprises/{enterprise_id}/device_pinners`

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.

## Path parameters

- `enterprise_id` string, required

## Query parameters

- `marker` string
- `limit` integer
- `direction` 'ASC' | 'DESC'

## Response `200`

Returns a list of device pins for a given enterprise.

- DevicePinners — A list of device pins.
  - `entries` DevicePinner[] — A list of device pins.
    - `id` string — The unique identifier for this device pin.
    - `type` 'device_pinner' — The value will always be `device_pinner`.
    - `owned_by` object — The user that the device pin belongs to.
      - `id` string, required — The unique identifier for this user.
      - `type` 'user', required — The value will always be `user`.
      - `name` string — The display name of this user.
      - `login` string, email — The primary email address of this user.
    - `product_name` string — The type of device being pinned.
  - `limit` integer — 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.
  - `next_marker` integer — The marker for the start of the next page of results.
  - `order` object[] — The order by which items are returned.
    - `by` 'id' — The field that is ordered by.
    - `direction` 'asc' | 'desc' — The direction to order by, either ascending or descending.

## Other responses

- `default` — An unexpected client error.

---

[API](https://skmtc.net/box/apis/platform-api.md) · [All operations](https://skmtc.net/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/box/platform-api/revisions/ba8f087e1a4d/schema)