Skip to main content
POST
Check premium subscription

Authorizations

Authorization
string
header
required

Access token issued by gtm.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.

Team-SID
string
header
required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Path Parameters

sid
string
required

LinkedIn account sid (ln_ac_…).

Required string length: 18
Pattern: ^ln_ac_

Body

application/json

Request body of check_linkedin_account_premium_subscription.

checks
enum<string>[] | null

Which steps to run. OMIT for all four, which is the normal call. premium reads the profile flag and, on a full run, settles both seats when it comes back false. sales_nav and recruiter probe one seat each and are the cheap ones. inmail_credits reads the pool the plan has: the Sales Navigator grant into inmail_credits with a seat, the Premium plan's own balance into premium_inmail_credits for a Premium account without one, and, next to either, the Recruiter contract's own balance into recruiter_inmail_credits for an ACTIVE Recruiter seat (LinkedIn keeps the three pools apart; a signed-out seat is not read and keeps its last number). An account with no Premium has no pool: on a full run the step is skipped (last known balances kept), and naming it in checks for one is refused with 422 premium_required. Asking for a subset skips the rest entirely, so nothing you did not ask for is re-read or re-written.

Required array length: 1 - 4 elements
Available options:
premium,
sales_nav,
recruiter,
inmail_credits

Response

action success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
action
action
string
required

kebab-case verb; matches the route segment.

item
object | null
required
result
object
required
meta
object
required
pacing
object