Users

Get the account's premium subscription

Returns the connected account's LinkedIn premium entitlement inventory, whether it holds Premium, the plan title, and the external manage/cancel/switch links, plus the complete set when the account holds more than one plan. A free account is a valid 200 empty state, not an error.

get/v1/{account_id}/profile/subscription

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/profile/subscription
  • Auth: HTTP bearer

Path parameters

account_idstring required

The connected LinkedIn account whose own insights to read.

Response

The account's premium entitlement inventory. A free account is a valid 200 empty state (has_premium:false, all *_url:null, subscriptions:[]) with an identical key set; never a 403. The external manage/cancel/switch URLs are LinkedIn-owned pass-through links.

object'profile_subscription' required

Response type discriminator.

has_premiumboolean required

true when the account holds at least one real premium plan; false for a free account. Keys on a real plan title, not on array length.

plan_titlestring nullable required

Title of the primary (first) plan; null when free.

descriptionstring nullable required

Human status line for the primary plan, or the no-premium message for a free account. Display only, never branch on it.

manage_urlstring nullable required

External manage URL for the primary plan; null when free.

cancel_urlstring nullable required

External cancel URL for the primary plan; null when free. May be served over http://, surfaced verbatim.

switch_urlstring nullable required

External switch/upgrade URL for the primary plan; null when free.

actionsobject required

The primary plan's action map (action key -> external URL); {} for a free account.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.