Subscription

Manage your Linked API subscription programmatically. For general Admin API information, see the Admin overview.

subscription.getStatus

Get current subscription status.

bash

curl -X POST https://api.linkedapi.io/admin/subscription.getStatus \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here"

Response:

json

{
  "success": true,
  "result": {
    "status": "active",
    "eligibleForTrial": false,
    "cancelAtPeriodEnd": false
  }
}

Field	Type	Description
`status`	`string` or `undefined`	`active`, `trialing`, `past_due`, `canceled`, or `undefined` if no subscription
`eligibleForTrial`	`boolean`	Whether a 7-day free trial is available
`cancelAtPeriodEnd`	`boolean`	Whether the subscription is scheduled to cancel at the end of the current billing period

subscription.getSeats

Get active subscription seats.

bash

curl -X POST https://api.linkedapi.io/admin/subscription.getSeats \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here"

Response:

json

{
  "success": true,
  "result": {
    "seats": [
      {
        "seatType": "plus",
        "quantity": 10,
        "billingPeriod": "year"
      }
    ]
  }
}

Field	Type	Description
`seatType`	`"core"` \	`"plus"`	Seat tier. `plus` unlocks Sales Navigator actions (`nv.*`)
`quantity`	`number`	Number of seats. Each seat allows one connected LinkedIn account
`billingPeriod`	`"month"` \	`"year"`	Billing cycle

subscription.getPricing

Get available pricing options.

bash

curl -X POST https://api.linkedapi.io/admin/subscription.getPricing \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here"

Response:

json

{
  "success": true,
  "result": {
    "products": [
      {
        "id": "price_...",
        "seatType": "core",
        "billingPeriod": "month",
        "unitPrice": 6900,
        "currency": "usd"
      },
      {
        "id": "price_...",
        "seatType": "plus",
        "billingPeriod": "year",
        "unitPrice": 88800,
        "currency": "usd"
      }
    ]
  }
}

Field	Type	Description
`id`	`string`	Stripe price identifier
`seatType`	`"core"` \	`"plus"`	Seat tier
`billingPeriod`	`"month"` \	`"year"`	Billing cycle
`unitPrice`	`number`	Price per seat in minor currency units. E.g., `6900` = $69.00
`currency`	`"usd"` \	`"eur"`	Currency of the price

subscription.setSeats

Set the number of subscription seats. If you already have an active subscription, the quantity is updated immediately. If not, a Stripe checkout link is returned.

bash

curl -X POST https://api.linkedapi.io/admin/subscription.setSeats \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here" \
  -d '{
    "quantity": 5,
    "billingPeriod": "year",
    "seatType": "plus"
  }'

Body:

Field	Type	Required	Description
`quantity`	`number`	Yes	Number of seats (1–1000)
`billingPeriod`	`"month"` \	`"year"`	Yes	Billing cycle
`seatType`	`"core"` \	`"plus"`	Yes	Seat tier

Response (subscription exists):

json

{
  "success": true,
  "result": {
    "status": "complete"
  }
}

Response (no subscription, checkout required):

json

{
  "success": true,
  "result": {
    "status": "processing",
    "paymentLink": "https://checkout.stripe.com/..."
  }
}

Note: When reducing seats below the number of connected accounts, excess accounts will be automatically frozen. Changes are applied in Stripe immediately but may take a few seconds to reflect in the API due to webhook processing.

subscription.getBillingLink

Get a link to the Stripe billing portal where you can manage payment methods, view invoices, and update billing details.

bash

curl -X POST https://api.linkedapi.io/admin/subscription.getBillingLink \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here"

Response:

json

{
  "success": true,
  "result": {
    "stripeLink": "https://billing.stripe.com/p/session/..."
  }
}

subscription.cancel

Cancel the subscription at the end of the current billing period. Accounts remain active until the period ends.

bash

curl -X POST https://api.linkedapi.io/admin/subscription.cancel \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here"

Response:

json

{
  "success": true,
  "result": {
    "cancelAtDate": "2026-04-18T00:00:00.000Z"
  }
}

Warning: This is a real cancellation. After the billing period ends, all connected LinkedIn accounts will be disconnected.

PreviousOverview NextAccounts