Facebook Pixel
APILinkedIn Account

Get specific account status

Retrieve the current status of a specific LinkedIn account by ID. Returns account details including name, public ID, subscription status, and session validity. Useful for multi-account setups to check individual account status.

GET/account/{accountId}/status
Authentication requiredAccount

Code Examples

curl -X GET 'https://api.connectsafely.ai/linkedin/account/<accountId>/status' \
-H 'Authorization: Bearer <your_api_key>'

Parameters

NameInRequiredTypeDescription
accountIdpathYesstringUnique identifier for the LinkedIn account (24-character hex string)

Request Body

No request body.

Responses

StatusDescription
200Account status retrieved successfully
400Invalid account ID format
401Unauthorized - Invalid or missing API key
404Account not found or not accessible

200 Response Parameters

NameTypeDescription
idstringUnique account identifier
firstNamestringLinkedIn user first name
lastNamestringLinkedIn user last name
publicIdstringLinkedIn public profile ID (e.g., "john-doe-123")
platformstringPlatform name (e.g., "ConnectSafely")
statusstringAccount subscription status (e.g., "FREE", "PREMIUM")
enabledbooleanWhether the account is enabled for automation
lastUsedstring (date-time)Last activity timestamp
hasTokensbooleanWhether valid LinkedIn session tokens exist

200 Example

{
  "id": "696ce9e780e0483585e4e553",
  "firstName": "John",
  "lastName": "Doe",
  "publicId": "john-doe-123",
  "platform": "ConnectSafely",
  "status": "FREE",
  "enabled": true,
  "lastUsed": "2026-02-24T04:53:13.750Z",
  "hasTokens": true
}

400 Response Parameters

NameTypeDescription
errorstring

400 Example

{
  "error": "Invalid account ID format"
}

401 Response Parameters

NameTypeDescription
errorstring

401 Example

{
  "error": "Unauthorized - Invalid credentials"
}

404 Response Parameters

NameTypeDescription
errorstring

404 Example

{
  "error": "LinkedIn account not found or not accessible"
}