---
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. Returns the API key once the session has been approved in the browser.

## 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

---

[API](https://skmtc.net/paragraph-xyz/apis/paragraph-api.md) · [All operations](https://skmtc.net/paragraph-xyz/apis/paragraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paragraph-xyz/paragraph-api/versions/7bbf1b62c1a0/schema)