Get account status

Retrieve the current status of a LinkedIn account. If accountId is provided, returns that specific account. Otherwise returns the most recently used account for the authenticated user.

GET/account/status

Authentication requiredAccount

Code Examples

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

Parameters

Name	In	Required	Type	Description
`accountId`	query	No	string	Optional LinkedIn account ID. If omitted, returns the most recently used account.

Request Body

No request body.

Responses

Status	Description
200	Account status retrieved successfully
401	Unauthorized - Invalid or missing API key
404	No LinkedIn account found for this user

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
  }
}

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": "example_value"
}

Code Examples

On this page