---
title: "Get dep token by id"
method: GET
path: "/tenant/v0/deptokens/{id}/"
tags: ["tenant_DEP Tokens"]
---

# Get dep token by id

`GET /tenant/v0/deptokens/{id}/`

Retrieves the details of a single DEP token by its UUID.

Returns metadata including the token name, current state, expiry date, and audit timestamps — useful for checking the status of a specific token before renewal or upload operations.

**About Get DEP Token by ID**

DEP tokens in Esper go through a two-step setup: public key generation (CSR_GENERATED) followed by ABM server token upload (COMPLETED). This endpoint lets you inspect a specific token's full record without fetching the entire list, which is especially useful in tenants with multiple active DEP tokens. The state field confirms whether the token exchange with Apple Business Manager is complete and the integration is ready for device enrollment.

**Key Fields / Query Parameters**

id (path, required, UUID) — The unique identifier of the DEP token record.

state — Current token state: CSR_GENERATED or COMPLETED.

token_name — The label assigned to the token during upload.

meta.token_expiry_on — Token expiry date; critical for renewal planning.

created_at / updated_at — Audit timestamps for when the token was created and last modified.

**Common Use Cases**

Checking whether a specific DEP token setup is complete before onboarding iOS devices

Retrieving expiry information for a single token as part of a renewal workflow

Confirming token state has transitioned to COMPLETED after uploading the ABM server token via PUT /api/tenant/v0/deptokens/{id}/

**Best Practices**

Call this endpoint after completing the ABM server token upload to confirm the state has transitioned to COMPLETED before attempting to enroll devices.

Use meta.token_expiry_on to set renewal reminders well in advance — expired DEP tokens block automatic device enrollment.

## Path parameters

- `id` string, UUID, required

## Response `200`

Get DEP token by id

- object
  - `code` integer
  - `message` string
  - `content` object
    - `schema` TenantDEPTokenGET
      - `id` string, UUID — id of DEP token
      - `token_name` string — name of DEP Token
      - `meta` object — meta information about the DEP token
        - `token_expiry_on` string
      - `state` 'CSR_GENERATED' | 'COMPLETED' — state of DEP token upload
      - `created_by` string — user id of the user
      - `updated_by` string — user id of the user
      - `created_at` string — Timestamp of DEP token creation
      - `updated_at` string — Timestamp of DEP token creation

## Other responses

- `401` — Get DEP token by id error - Unauthorized
- `404` — Not Found
- `500` — Get DEP token by id error - Internal Server Error

---

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