---
title: "Poll device login"
method: GET
path: "/v1/login/device/{device_code}"
tags: ["Auth"]
---

# Poll device login

`GET /v1/login/device/{device_code}`

Polls a CLI device login until complete, pending, or expired.

## Path parameters

- `device_code` string, required

## Response `200`

Device login poll result.

- LoginPollResponse — Device login poll response.
  - `status` 'pending' | 'complete' | 'expired', required
  - `intervalSeconds` integer, required
  - `accountId` string, nullable, required
  - `email` string, email, nullable, required
  - `provider` 'google' | 'github' | 'null', nullable, required
  - `token` string, nullable, required
  - `expiresAt` string, date-time, nullable, required

## Other responses

- `400` — Bad request.
- `401` — Unauthorized.
- `429` — Too many requests.
- `500` — Internal server error.

## Changes

- **2026-07-03** `3f7925dc651d` — 1 breaking, 1 warning, 6 info
  - removed the required property `expires_at` from the response with the `200` status
  - added the new `complete` enum value to the `status` response property for the response status `200`
  - removed the `authorized` enum value from the `status` response property for the response status `200`
  - added the required property `accountId` to the response with the `200` status
  - …4 more
- **2026-06-05** `3985c6090c91` — 24 breaking, 5 warning, 75 info
  - for the `path` request parameter `device_code`, the maxLength was decreased from `512` to `128`
  - for the `path` request parameter `device_code`, the minLength was increased from `0` to `1`
  - the response property `checkout_url` became nullable for the status `400`
  - the response property `checkout_url` became nullable for the status `401`
  - …100 more

[Change history](https://skmtc.dev/tovuk/apis/tovuk-api/changes/v1/login/device/:device_code/get.md)

---

[API](https://skmtc.dev/tovuk/apis/tovuk-api.md) · [All operations](https://skmtc.dev/tovuk/apis/tovuk-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tovuk/tovuk-api/revisions/ef06c3a9c42b/schema)
