> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkupapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Account Details

> Get detailed information about a specific account

Retrieve detailed information about a specific account, including its configuration and current status.

<Note>
  This endpoint costs **0 credits**.
</Note>

### Header Parameters

<ParamField header="x-api-key" type="string" required>
  Your API key
</ParamField>

### Path Parameters

<ParamField path="account_id" type="string" required>
  The unique identifier of the account to retrieve
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Whether the request was successful
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="Properties">
    <ResponseField name="account_id" type="string">
      Unique identifier for the account
    </ResponseField>

    <ResponseField name="platform" type="string">
      Platform type (e.g. "linkedin")
    </ResponseField>

    <ResponseField name="account_name" type="string">
      Display name of the account
    </ResponseField>

    <ResponseField name="is_active" type="boolean">
      Whether the account is currently active and usable
    </ResponseField>

    <ResponseField name="status" type="string">
      Account status, always in step with `is_active`:

      * `connected` — ready to use (`is_active: true`)
      * `checkpoint_required` — waiting on a 2FA code, see [Checkpoint](/api-reference/v2/accounts/checkpoint)
      * `disconnected` — the LinkedIn session expired; re-authenticate via [Connect Account](/api-reference/v2/accounts/login)
    </ResponseField>

    <ResponseField name="checkpoint_type" type="string">
      Where the code went, when `checkpoint_required`: `email`, `sms`, `authenticator_app`, `app_approval` or `code`.
    </ResponseField>

    <ResponseField name="sent_to" type="string">
      Masked destination when LinkedIn shows it, e.g. `phone number ending with 23`.
    </ResponseField>

    <ResponseField name="country" type="string">
      Country code associated with the account
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the account was created
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp of the last account update
    </ResponseField>

    <ResponseField name="sales_nav" type="object">
      State of the account's Sales Nav seat — same shape as in [List Accounts](/api-reference/v2/accounts/list-accounts#sales-nav-seat).

      <Expandable title="sales_nav properties">
        <ResponseField name="connected" type="boolean">
          Whether the account currently has a usable Sales Nav seat.
        </ResponseField>

        <ResponseField name="contract_id" type="string">
          Sales Nav contract the seat belongs to.
        </ResponseField>

        <ResponseField name="seat_id" type="string">
          The seat within that contract.
        </ResponseField>

        <ResponseField name="connected_at" type="string">
          Last seat activation or refresh. Only when `connected` is `true`.
        </ResponseField>

        <ResponseField name="reason" type="string">
          Why the seat is unavailable. Only when `connected` is `false` and a seat existed before.
        </ResponseField>

        <ResponseField name="disconnected_at" type="string">
          When the seat was lost. Only when the seat died on its own.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="proxy" type="object">
      `{ "mode": "managed" }` or `{ "mode": "custom", "host": "...", "port": 8080 }` — see [Set Custom Proxy](/api-reference/v2/accounts/set-proxy). LinkedIn accounts only.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="metadata" type="object">
  <Expandable title="Properties">
    <ResponseField name="action" type="string">
      The action performed ("get\_account")
    </ResponseField>

    <ResponseField name="account_id" type="string">
      The account\_id that was queried
    </ResponseField>

    <ResponseField name="credits_consumed" type="integer">
      Number of credits consumed (always 0 for this endpoint)
    </ResponseField>

    <ResponseField name="timestamp" type="string">
      ISO 8601 timestamp of the response
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "success": true,
    "data": {
      "account_id": "acc_abc123",
      "platform": "linkedin",
      "account_name": "John Doe",
      "is_active": true,
      "status": "connected",
      "country": "FR",
      "created_at": "2025-10-15T08:30:00Z",
      "updated_at": "2026-03-20T14:22:00Z",
      "sales_nav": {
        "connected": true,
        "contract_id": "2016220713",
        "seat_id": "1545550052",
        "connected_at": "2026-03-20T14:22:00Z"
      },
      "proxy": { "mode": "managed" }
    },
    "metadata": {
      "action": "get_account",
      "account_id": "acc_abc123",
      "credits_consumed": 0,
      "timestamp": "2026-03-24T12:00:00Z"
    }
  }
  ```

  ```json Error Response theme={null}
  {
    "success": false,
    "error": {
      "code": "INVALID_ACCOUNT",
      "message": "The specified account_id does not exist"
    },
    "metadata": {
      "action": "get_account",
      "credits_consumed": 0,
      "timestamp": "2026-03-24T12:00:00Z"
    }
  }
  ```
</ResponseExample>

### Notes

* This endpoint is free and does not consume any credits
* Use this to check if an account is active before making action requests
* Use the dedicated webhook endpoints to configure webhooks for your accounts