API Reference/Endpoints

List your accounts

GET/api/linkedin/accounts

Every LinkedIn account this key has connected, with each one's account_id — the way to discover it programmatically without keeping your own copy of the connect response or opening the dashboard.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.

Response fields

FieldTypeDescription

accountsarrayEvery account this key owns, most recently connected first.

accounts[].idstringThis account's id. Use it with the status, checkpoint and action endpoints.

accounts[].labelstringThe name given to this account when it was connected.

accounts[].li_emailstring | nullThe LinkedIn login email used to connect it.

accounts[].li_countrystring | nullTwo-letter country code, if one was set at connect time.

accounts[].statusstringOne of not_connected, logging_in, awaiting_2fa, connected, error, disconnected.

accounts[].li_errorstring | nullA human-readable failure reason when status is error, otherwise null.

accounts[].li_checkpoint_typestring | nullSet while awaiting_2fa — see Check connection status.

accounts[].created_atstringISO 8601 timestamp of when this account was connected.

This is a first-party read against our own records — it never calls the LinkedIn engine, so it stays fast and available even if a specific account's connection is unhealthy. It's separate from GET /accounts on the gateway proxy, which is blocked because that path has no per-customer scoping.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.