---
title: "Get oauth session status"
method: GET
path: "/api/v2/oauth/session/status/{sessionId}"
tags: ["OAuth"]
---

# Get oauth session status

`GET /api/v2/oauth/session/status/{sessionId}`

Poll this endpoint to check the OAuth session result. Works for both Google and Microsoft OAuth sessions. Returns pending while waiting, success with account details when complete, or error if something went wrong. Sessions expire after 10 minutes.

## Path parameters

- `sessionId` string, required

## Response `200`

Default Response

- object
  - `status` 'pending' | 'success' | 'error' | 'expired' — Current status of the OAuth session
  - `email` string — Email of the connected account (on success)
  - `name` string — Name of the account owner (on success)
  - `error` string — Error code (on error)
  - `error_description` string — Human-readable error description (on error)

---

[API](https://skmtc.net/instantly/apis/api-explorer.md) · [All operations](https://skmtc.net/instantly/apis/api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instantly/api-explorer/revisions/378d1e253fe7/schema)