Facebook Pixel
APILinkedIn Account

Get account status

Retrieve the current status of the default LinkedIn account for the authenticated user. Returns account details including name, public ID, subscription status, and session validity. Use this to verify account connectivity before performing actions.

GET/account/status
Authentication requiredAccount

Code Examples

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

Parameters

No parameters.

Request Body

No request body.

Responses

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

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
}

401 Response Parameters

NameTypeDescription
errorstring

401 Example

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

404 Response Parameters

NameTypeDescription
errorstring

404 Example

{
  "error": "example_value"
}