What is an API?

A short guide for people who have never used one

Last reviewed

The basics

An API is a way for two computer programs to talk to each other. You use a website by clicking. A program uses an API by sending short messages. The API lets your own tools read or update what you keep with Expat183.

An API key is like a password for a program. You make one in your account and give it to the tool you want to connect. The key only lets the tool do the things you allow. You can switch it off at any time.

A test key is a key that only works with made-up demo data. You can use it to try things out. Nothing you do with it touches real records. Not every API has test keys yet. The table below shows which ones do.

A webhook works the other way round. Instead of your tool asking us for news, we send your tool a short message when something changes. For example, we can tell your tool when a document is ready.

New words on this page are all in the API glossary.

Which one is for me?

We cannot show the list of APIs just now. The developer access guide explains how to make a key and where to start.

What it costs

API access comes with some of our plans. There is no separate fee for each call, but each key has a limit on how many calls it can make in an hour.

The pricing page shows what each plan costs.

How your data stays safe

  • A key can only do the things you chose when you made it.
  • You can see each key in your account and switch it off at any time.
  • We keep a record of the calls each key makes, so you can check what it did.
  • Every call travels over an encrypted link.
  • We never show a key again after you make it. Keep it somewhere safe, like a password.

API terms at a glance

These lines tell you where each part of our legal documents covers the API. They only describe what each part is about. The documents themselves are what apply.

  • Terms of Service, the paragraph on personal API keys: What a personal key can do, and the extra checks before a key can download documents.
  • Acceptable Use Policy, section 9A: The rules for using the platform through the API or an AI assistant.
  • Privacy Policy, section 20: What data we keep when you use the consumer API, and for how long.
  • Professional Terms and Conditions, clauses 5.6 and 5.6A: The terms for firms that use the Professional API.
  • Data Processing Agreement, the employer programme sections: How staff data is handled for employers, including the Corporate Reporting API.

Ready to start?

The developer access guide shows how to make your first key.

Can’t find what you’re looking for?

Our support team is here to help. Contact us and we’ll get back to you as soon as possible.

Contact us

We use cookies to improve your experience. See our Cookie policy (opens in a new tab) for details.