---
title: "Poll for the result of a sign-in redirect"
method: GET
path: "/oauth/sessions/{state}"
---

# Poll for the result of a sign-in redirect

`GET /oauth/sessions/{state}`

## Request

- Base URL: `http://localhost:6286`
- URL: `http://localhost:6286/oauth/sessions/{state}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/iconik/apis/agent-api/docs/oauth/sessions/:state/get.ts> (a function with typed inputs; its response is checked against the schema)

A result is returned once and then forgotten. 404 until the browser has landed, and again once the result has expired.

## Path parameters

- `state` string, required

## Response `200`

Default Response

- OAuthSessionResult
  - `status` 'complete' | 'error', required
  - `code` string: The authorization code, when the status is complete
  - `error` string: The OAuth error code, when the status is error
  - `error_description` string

---

[API](https://skmtc.dev/iconik/apis/agent-api.md) - [All operations](https://skmtc.dev/iconik/apis/agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/iconik/apis/agent-api/revisions/cd5eb7819e60?raw)