---
title: "Poll an API auth session"
method: GET
path: "/v1/api/auth/sessions/{sessionId}"
tags: ["auth"]
---

# Poll an API auth session

`GET /v1/api/auth/sessions/{sessionId}`

Poll the status of an auth session. After approval, retries return the API key briefly until the client acknowledges delivery.

## Path parameters

- `sessionId` string, required

## Response `200`

Current session status

- union
  - object
    - `status` 'pending', required
    - `deviceName` string, required
    - `callbackUrl` string
  - object
    - `status` 'completed', required
    - `apiKey` string, required
  - object
    - `status` 'expired', required

## Other responses

- `404` — Session not found
- `500` — Internal server error

## Changes

- **2026-05-07** `90de04b87133` — 1 warning
  - removed the optional property `error` from the response with the `500` status
- **2026-03-30** `4a10ba483067` — 1 info
  - added the optional property `oneOf[subschema #1]/callbackUrl` to the response with the `200` status
- **2026-03-24** `66520a246641` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/paragraph-xyz/apis/paragraph-api/changes/v1/api/auth/sessions/:sessionId/get.md)

---

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