Plans and billing

How LinkinLegal API plans work: one plan per API with unlimited calls, set up by our team on a monthly or yearly tenure, paid by invoice, cancellation, and what 402 and 403 mean.

You get one plan per API. A plan gives unlimited calls to that API. The rate limit still applies.

The first API is the Sanctions API.

How to get access

API access is set up by our team. There is no purchase in the developer console. Write to support@linkinlegal.com and we agree with you:

  • which APIs you need,
  • the price of each API, and
  • the tenure: monthly or yearly.

We then create the plan, and the invoice is emailed to you at once by Stripe, our payment provider, with 30-day terms. Access starts when the first invoice is paid. After that, the plan renews every month or every year on the same date, and Stripe emails a new invoice each time.

Your plans, prices and renewal dates are shown in the developer console at /developer/billing.

Who can get access

Only the owner of an active LinkinLegal app subscription can hold an API plan.

Your accountCan hold an API plan
Owner of an active app subscriptionYes
Seat member on somebody else's subscriptionNo
Pass holderNo
Free firm listing onlyNo

The API plan follows the app subscription. If the app subscription ends, calls return 403 subscription_required, and the API plan is set to end with the period you already paid for.

Add an API later

Write to the same address. When we add an API on the same tenure in the middle of a billing period:

  1. An invoice for the rest of the current period is emailed to you now.
  2. From the next renewal, the API is one more line on the same invoice.

An API on the other tenure gets its own invoice and renewal date. Your other APIs do not change.

Cancel an API

To cancel an API, write to support@linkinlegal.com. What happens:

  • Access continues until the end of the period you paid for.
  • After that, calls to that API return 402 plan_required.
  • There is no refund for the rest of the period.
  • Your other APIs keep running.

A late payment

If a renewal invoice is not paid, the plan goes to past_due. Access stays on while the invoice is open. If it is never paid, the plan is cancelled and calls return 402 plan_required.

What the errors mean

ErrorMeaningWhat to do
402 plan_requiredThis account has no live plan for the API you called. It was never set up, it was cancelled, or it was never paid.Contact support@linkinlegal.com.
403 subscription_requiredThe plan exists, but the LinkinLegal app subscription behind it is not active.Renew the app subscription. Calls work again in about one minute. The API plan is still set to end with the paid period: contact us to restart it after that date.

Both are decisions about your account, not about your request. Do not retry them: the same call fails again until the plan or the subscription is fixed. Read Errors for the full list.

On this page