Aira Connect includes a REST API, so your team can pull Aira's company data, portfolio and deep research into your own systems. It is server-to-server, authenticated with an API key you create in Aira's settings.
This article is an overview and covers how to create and manage your keys. The full technical reference, with every endpoint and example, lives at api.aira.app. The API is one of the ways Aira connects to your stack, alongside the integrations Aira supports.
What you can do with it
The API exposes the same data you work with inside Aira:
Search Aira's company database and find lookalike companies.
Read a company's profile, contacts, news and registry filings.
Add companies to your portfolio, and pull news and filings for everything you follow.
Save and reuse company views.
Run deep research jobs and collect the reports.
Check your identity and quota usage.
Create an API key
In Aira, open Settings and go to API keys, then:
Select Create key.
Name the key after where you will use it, so you know what breaks if you ever revoke it, then select Create key.
Copy the key and store it somewhere safe, such as your secret manager. This is the only time Aira shows you the key: it is stored hashed and cannot be retrieved later, not even by Aira. If you lose it, revoke the key and create a new one.
Select I've stored the key.
Keys are prefixed aira_live_, act for your whole organization and share its quota. You can create as many as you need.
Authenticate your requests
The API is server-to-server: call it from your own backend, never from a browser. A key that works in a browser is a key your users can read, so Aira rejects browser calls.
Send your key as a bearer token against the base URL https://ai.aira.app/api. The simplest call confirms your key is live and returns your organization:
curl https://ai.aira.app/api/v1/me -H "Authorization: Bearer aira_live_your_key_here"
A 200 response means the key authenticates. A 401 means it is missing, revoked or unknown.
Manage and revoke keys
The API keys page lists every key with its name, status, when it was created and when it was last used.
To retire a key, select Revoke. Revoking takes effect immediately and cannot be undone: any request still using that key starts failing at once, so move anything that depends on it to a new key first.
To rotate a key, create a new one, switch your integration over to it, then revoke the old one.
What to know before you build
Keys are organization-wide. Every key has full access to the whole API and acts for your whole organization. There is no per-key scope, so treat a key like a password.
Rate limits are shared. Aira allows 120 requests a minute for reads and 20 a minute for adding companies to your portfolio, across your whole organization. A second key does not double them. Every response tells you how much of the current window is left.
Quota counts companies, not calls. Your plan's quota counts the distinct companies you pull over a period, not the number of requests. Reads are free, and adding a company you already hold again costs nothing.
Coverage is 14 markets. Company data covers Austria, Belgium, Denmark, Finland, France, Germany, Ireland, Italy, Luxembourg, Netherlands, Norway, Spain, Sweden and the United Kingdom. Some data covers less: registry filings are Sweden and Norway only.
There is no sandbox. Every key is a live key and every call runs against your real organization. Reads are free to experiment with, but adding companies and running deep research have real effects: adds are visible to everyone in your organization and sync to a connected CRM, and each research job spends against your AI research budget.
Where the API can be used
The API is for your organization's internal use. You can use Aira's data inside your own business to find, research and manage companies. You cannot redistribute it to third parties or show it to users of your own product, which follows from the licences covering Aira's company data. If your use case involves showing Aira data outside your organization, talk to your account manager first.
Read the full API reference
This overview covers the essentials. The complete reference, with every endpoint, field, error code and example, lives at api.aira.app. Point your developers there when they are ready to build.