Get account premium status

Retrieve the premium subscription status of a LinkedIn account. Returns information about whether the account has Sales Navigator, Recruiter, Business Premium, or no premium subscription. Also includes feature access flags for various premium capabilities.

GET/account/{accountId}/premium

Authentication requiredAccount

Code Examples

curl -X GET 'https://api.connectsafely.ai/linkedin/account/<accountId>/premium' \
  -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	Premium status retrieved successfully
400	Invalid account ID format
401	Unauthorized - Invalid or missing API key
404	Account not found or not accessible
500	Internal server error

200 Response Parameters

Name	Type	Description
`success`	boolean	Whether the request was successful
`accountId`	string	Unique account identifier
`accountName`	string	Full name of the LinkedIn account owner
`premiumType`	string	Type of premium subscription
`isPremium`	boolean	Whether the account has any premium subscription
`hasSalesNavigator`	boolean	Whether the account has Sales Navigator access
`hasRecruiter`	boolean	Whether the account has Recruiter access
`hasAwayMessages`	boolean	Whether the account can set away messages (Business Premium feature)
`hasAdvertiseBadge`	boolean	Whether the account has advertise badge access
`hasHiringManager`	boolean	Whether the account has hiring manager mailbox access
`features`	array	Detailed list of feature access flags

200 Example

{
  "success": true,
  "accountId": "696ce9e780e0483585e4e553",
  "accountName": "John Doe",
  "premiumType": "SALES_NAVIGATOR",
  "isPremium": true,
  "hasSalesNavigator": true,
  "hasRecruiter": false,
  "hasAwayMessages": true,
  "hasAdvertiseBadge": false,
  "hasHiringManager": false,
  "features": [
    {
      "featureAccessType": "CAN_ACCESS_SALES_NAV_BADGE",
      "hasAccess": true,
      "entityUrn": "urn:li:fs_premiumFeatureAccess:CAN_ACCESS_SALES_NAV_BADGE"
    },
    {
      "featureAccessType": "CAN_ACCESS_AWAY_MESSAGES",
      "hasAccess": true,
      "entityUrn": "urn:li:fs_premiumFeatureAccess:CAN_ACCESS_AWAY_MESSAGES"
    },
    {
      "featureAccessType": "CAN_ACCESS_RECRUITER_MAILBOX",
      "hasAccess": false,
      "entityUrn": "urn:li:fs_premiumFeatureAccess:CAN_ACCESS_RECRUITER_MAILBOX"
    },
    {
      "featureAccessType": "CAN_ACCESS_HIRING_MANAGER_MAILBOX",
      "hasAccess": false,
      "entityUrn": "urn:li:fs_premiumFeatureAccess:CAN_ACCESS_HIRING_MANAGER_MAILBOX"
    },
    {
      "featureAccessType": "CAN_ACCESS_ADVERTISE_BADGE",
      "hasAccess": false,
      "entityUrn": "urn:li:fs_premiumFeatureAccess:CAN_ACCESS_ADVERTISE_BADGE"
    }
  ]
}

400 Response Parameters

Name	Type	Description
`error`	string

400 Example

{
  "error": "Invalid account ID format",
  "success": false
}

401 Response Parameters

Name	Type	Description
`error`	string

401 Example

{
  "error": "Unauthorized"
}

404 Response Parameters

Name	Type	Description
`error`	string

404 Example

{
  "error": "LinkedIn account not found or not accessible",
  "success": false
}

500 Response Parameters

Name	Type	Description
`error`	string

500 Example

{
  "error": "Failed to fetch premium status",
  "success": false
}

Code Examples

On this page