---
title: "Get pending OAuth data"
method: GET
path: "/v1/connect/pending-data"
tags: ["Connect"]
---

# Get pending OAuth data

`GET /v1/connect/pending-data`

Fetch pending OAuth data for headless mode using the pendingDataToken from the redirect URL.

**Scope**: This endpoint is used for LinkedIn organizations, Google Business Profile locations, Slack channels, Snapchat profiles, and Pinterest boards, where the selection list is too large to fit in URL params. The redirect carries a `pendingDataToken` instead of the full payload; the response includes the corresponding selection array (e.g. `boards` for Pinterest). WhatsApp, Facebook and other platforms pass selection state directly via URL query params on the redirect (`profileId`, `tempToken`, `step`), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. `/v1/connect/whatsapp/select-phone-number`).

Reading the token does not consume it, so this fetch is repeatable until the token expires 1 hour after issuance. Completing the platform selection deletes the pending record, so the token stops working from then on. No authentication required.

## Query parameters

- `token` string, required

## Response `200`

OAuth data fetched successfully

- object
  - `platform` string — The platform (e.g., "linkedin")
  - `profileId` string — The Zernio profile ID
  - `tempToken` string — Temporary access token for the platform
  - `refreshToken` string — Refresh token (if available)
  - `expiresIn` number — Token expiry in seconds
  - `userProfile` object — User profile data (id, username, displayName, profilePicture)
  - `selectionType` 'organizations' | 'pages' | 'boards' | 'locations' | 'profiles' — Type of selection data
  - `organizations` object[] — LinkedIn organizations (when selectionType is "organizations")
    - `id` string
    - `urn` string
    - `name` string
    - `vanityName` string

## Other responses

- `400` — Missing token parameter
- `404` — Token not found or expired

## Changes

- **2026-09-16** `3e6ddf2a99ea` — 2 info
  - added the optional property `details/budgetScope` to the response with the `400` status
  - added the optional property `details/budgetScope` to the response with the `404` status
- **2026-09-15** `0dba7d004d75` — 4 info
  - added the optional property `details/quotaExhausted` to the response with the `400` status
  - added the optional property `details/quotaExhausted` to the response with the `404` status
  - added the optional property `details/quotaScope` to the response with the `400` status
  - added the optional property `details/quotaScope` to the response with the `404` status

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/connect/pending-data/get.md)

---

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