Get pending connection details

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

fetch("https://api.outstand.so/v1/social-accounts/pending/string", {  method: "GET"})

{
  "success": true,
  "data": {
    "network": "linkedin",
    "expiresAt": 1734567890000,
    "availablePages": [
      {
        "id": "abc123",
        "type": "organization",
        "name": "Acme Inc",
        "username": "acme-inc",
        "profilePictureUrl": "https://example.com/profile.jpg",
        "category": "Real Estate Agent",
        "urn": "urn:li:organization:12345",
        "accountId": "accounts/1234567890",
        "address": "12 Example St, Sydney NSW 2000"
      }
    ]
  }
}

{
  "success": false,
  "error": "Session expired or invalid"
}

{
  "success": false,
  "error": "Internal server error",
  "message": "Database connection failed"
}