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 account | Can hold an API plan |
|---|---|
| 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 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:
- An invoice for the rest of the current period is emailed to you now.
- 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
402plan_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
| Error | Meaning | What to do |
|---|---|---|
402 plan_required | This 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_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 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.