---
title: "Get device code status"
method: GET
path: "/agents/device-codes/{code}/status"
tags: ["Agent Management"]
---

# Get device code status

`GET /agents/device-codes/{code}/status`

Check whether a device code has been redeemed. Use this to poll for agent installation completion after creating an agent.

## Response `200`

Successful operation

- AgentDeviceCodeStatusResponse
  - `code` string, required — The device code.
  - `redeemed` boolean, required — Whether this device code has been redeemed.

## Other responses

- `401` — Unauthorized
- `404` — Device code not found
- `500` — Internal service error

---

[API](https://skmtc.net/stainless-api/apis/grid-api.md) · [All operations](https://skmtc.net/stainless-api/apis/grid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stainless-api/grid-api/versions/526036c12609/schema)