---
title: "Get pending connection details"
method: GET
path: "/v1/social-accounts/pending/{sessionToken}"
tags: ["Pending Connections"]
---

# Get pending connection details

`GET /v1/social-accounts/pending/{sessionToken}`

## Request

- Base URL: `https://api.outstand.so`
- URL: `https://api.outstand.so/v1/social-accounts/pending/{sessionToken}`
- Auth: none declared

Retrieve details of a pending OAuth connection, including available pages/accounts that can be connected. This endpoint is used during the OAuth finalization flow for platforms like LinkedIn and Facebook that support multiple pages/profiles.

**Authentication:** Requires your API key, *and* the session token must belong to the same organization as that key. A session token from another organization is rejected as if it had expired. Because the API key is required, call this from your backend - not from the browser your user was redirected to.

**Tokens are never returned.** The response describes each page only well enough to render a picker (`id`, `name`, `profilePictureUrl` and similar). Provider access tokens stay server-side and are attached to the account when you finalize.

**Flow:**
1. User completes OAuth authentication
2. Callback redirects to your page with `?session=xxx`
3. Your backend calls this endpoint to get available pages. Strip the `session` parameter from the browser URL once you have read it - it lands in history, logs and `Referer` headers otherwise
4. User selects which pages to connect
5. Call POST /finalize to complete the connection

## Path parameters

- `sessionToken` string, required

## Response `200`

Pending connection retrieved successfully

- object: Pending connection data with available pages
  - `success` boolean, required
  - `data` object, required
    - `network` string, required: Social network type
    - `expiresAt` number, required: Unix timestamp when the session expires
    - `availablePages` object[], required
      - `id` string, required: Unique identifier for the page/account
      - `type` 'personal' | 'organization' | 'page' | 'location', required: Type of account
      - `name` string, required: Display name of the account
      - `username` string, required: Username or handle
      - `profilePictureUrl` string: URL to the profile picture
      - `category` string: Facebook Page category
      - `urn` string: LinkedIn URN for the profile or organization
      - `accountId` string: Google Business Profile account the location belongs to
      - `address` string: Formatted address of a Google Business Profile location

## Other responses

- `404`: Session expired or invalid
- `500`: Internal server error

---

[API](https://skmtc.dev/outstand/apis/outstand-social-accounts-api-v1.md) · [All operations](https://skmtc.dev/outstand/apis/outstand-social-accounts-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/outstand/apis/outstand-social-accounts-api-v1/revisions/181fad55d031?raw)