Plans and billing

How LinkinLegal API plans work: one monthly plan per API with unlimited calls, who can buy, card and invoice payment, cancellation, and what 402 and 403 mean.

You buy one plan per API. A plan is monthly and gives unlimited calls to that API. The rate limit still applies.

The first API is the Sanctions API. Each new API is its own plan on the same subscription and on the same monthly invoice.

The price of each API is shown in the developer console at /developer/billing before you pay.

Who can buy

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

Your account	Can buy an API
Owner of an active app subscription	Yes
Seat member on somebody else's subscription	No
Pass holder	No
Free firm listing only	No

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 month you already paid for.

Pay by card

Buy the API in the developer console. You pay by card through our payment provider, Stripe. The card is saved, and the plan renews every month on the same date.

Pay by invoice

Large customers can pay by invoice with 30-day terms. Write to support@linkinlegal.com to set this up.

An invoice customer cannot add an API in the console. Write to the same address and we add it to the contract.

Add an API later

When you add a second API in the middle of a billing month:

The saved card is charged now for the rest of the current month.
From the next renewal, the API is one more line on the same monthly invoice.

Your other APIs do not change.

Cancel an API

Cancel one API in the console. What happens:

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

A failed payment

If the card fails at renewal, the plan goes to past_due. Access stays on while the payment is retried. If you must change the card, write to support@linkinlegal.com.

If every retry fails, the plan is cancelled and calls return 402 plan_required.

What the errors mean

Error	Meaning	What to do
`402` `plan_required`	This account has no live plan for the API you called. It was never bought, it was cancelled, or every payment retry failed.	Buy or renew the API at `/developer/billing`.
`403` `subscription_required`	The 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 month: buy it again in the console 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.