Get specific account status

Retrieve the current status of a specific LinkedIn account by ID. Returns account details including name, public ID, operational status, session validity, and LinkedIn plan info (premium type). 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

Name	In	Required	Type	Description
`accountId`	path	Yes	string	Unique identifier for the LinkedIn account (24-character hex string)

Request Body

No request body.

Responses

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

200 Response Parameters

Name	Type	Description
`id`	string	Unique account identifier
`firstName`	string	LinkedIn user first name
`lastName`	string	LinkedIn user last name
`publicId`	string	LinkedIn public profile ID (e.g., "john-doe-123")
`platform`	string	Platform name (e.g., "ConnectSafely")
`status`	string	Internal account operational status (AVAILABLE = available, IN_USE = busy, ERROR = needs attention)
`enabled`	boolean	Whether the account is enabled for automation
`lastUsed`	string (date-time)	Last activity timestamp
`hasTokens`	boolean	Whether valid LinkedIn session tokens exist
`linkedinPlan`	object	LinkedIn premium plan info (only returned for accounts with AVAILABLE or WARMUP status, cached for 12 hours)

200 Example

{
  "id": "696ce9e780e0483585e4e553",
  "firstName": "John",
  "lastName": "Doe",
  "publicId": "john-doe-123",
  "platform": "ConnectSafely",
  "status": "AVAILABLE",
  "enabled": true,
  "lastUsed": "2026-02-24T04:53:13.750Z",
  "hasTokens": true,
  "linkedinPlan": {
    "premiumType": "NON_PREMIUM",
    "isPremium": false,
    "hasSalesNavigator": false,
    "hasRecruiter": false,
    "hasAwayMessages": false,
    "hasAdvertiseBadge": false,
    "hasHiringManager": false
  }
}

400 Response Parameters

Name	Type	Description
`error`	string

400 Example

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

401 Response Parameters

Name	Type	Description
`error`	string

401 Example

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

404 Response Parameters

Name	Type	Description
`error`	string

404 Example

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

Code Examples

On this page