ProductsCompany API
Turn a domain into a full company profile.
Send a domain and get back the company's size, industry, locations and contact details as JSON. Every profile has a Firmable ID that the rest of the API uses.
- Prefill sign-up and onboarding forms
- Enrich every account in your CRM
- Give your agent the facts before it acts
- Close to 21M companies
- 13 countries
- US$0.25 a profile, charged once
GET/company?fqdn=acme.example&country=US
Acme Logistics
acme.example
- Staff
- 180
- Size band
- 51 - 250
- Type
- Private company
- Founded
- 2009
- Head office
- Columbus, Ohio
- Industry
- Logistics and supply chain
Firmable IDf000000000001
Example data. The live API returns the same fields.
See what comes back
One request, one JSON profile. Choose a group of fields to see where it sits in the response.
GET/company?fqdn=acme.example&country=US
{ "id": "f000000000001", "name": "Acme Logistics", "website": "https://www.acme.example", "fqdn": "acme.example", "employee_count": 180, "company_size": "51 - 250", "company_type": "Private company", "year_founded": 2009, "hq_location": "Columbus, Ohio", "hq_country": "US", "locations": ["Columbus, Ohio", "Indianapolis, Indiana"], "industries": ["Logistics and supply chain"], "industry_codes": { "naics": "488510", "sic": "4731" }, "phones": ["+1 555 010 0100"], "emails": ["hello@acme.example"], "social_media": { "linkedin": "acme-logistics" }, "nextGen": { "web_traffic": { "summary": { "total_web_visitors": 48000 } }, "reviews_rating": { "overall_rating": "4.1", "total_reviews": 63 } } }
Example data, trimmed. Fields Firmable doesn't hold can come back as null.
Try it on your own data. Your free credit covers 100 profiles.
Before you build
Set the country
Add country=US to GET /company for US staff numbers, locations and codes. Without it, you get Australian data. The MCP tool get_company has no country option, so use the REST API for US data.
Keep the Firmable ID
Store the id from each profile. Every other Firmable call accepts it, so your records stay joined.
Pay once per company
The first lookup costs 1 credit. Every later lookup of the same company is free.
Expect empty fields
A field Firmable doesn't hold can come back as null. Check for it before you use a value.
What you can send
Send one identifier with each request. The country is optional.
| Identifiers | |
|---|---|
fqdn | The company's domain, such as acme.example |
website | The full website address |
ln_url | The company's LinkedIn URL |
ln_slug | The last part of that URL |
id | The Firmable ID from an earlier call |
abn | The Australian Business Number, for Australian companies |
| Country | |
country | US, CA, AU, NZ, SG, MY, ID, PH, HK, JP, VN, KR or TH. The default is AU. |
| Responses | |
200 | The company profile. |
400 | The country code isn't supported, or the request is malformed. |
429 | More than 15 requests a second on one key. Wait for the seconds in retry-after. |
What teams build with it
Prefill sign-up forms
- Take the domain from the sign-up email
- Look the company up
- Fill in its name, size and industry for the user
get_companyEnrich new CRM accounts
- Look up each new account by domain
- Write size, industry and location to the record
- Route it to the right territory
get_companyBuild target account lists
- Find companies by industry, size and location
- Pull full profiles for the ones you keep
- Give reps a list with the details filled in
filter_searchget_companyCheck a business before you approve it
- Look the applicant up by website
- Compare its industry with what it declared
- Send any mismatch for review
get_companyoffers_serviceSegment by company profile
- Enrich the campaign list
- Split it by size, industry and country
- Send each segment its own message
get_companyGround an agent in company facts
- Give the agent the get_company tool
- Let it look up any company it meets
- Answer from the profile, not the open web
get_companyUse it in your agent
Paste one prompt and your agent connects itself, makes a test call and remembers when to use it. Then ask in plain English, or call the tool by name for a check that runs the same way every time.
Set it up in one step
Set up Firmable Company API for me.
1. Connect the Firmable MCP server by following
https://agents.firmable.com/developer/setup.txt
Keep any MCP servers that are already configured.
2. If you need an API key instead of signing in, ask me for it. Keep it in an
environment variable called FIRMABLE_API_KEY or our secret store, never in
a file that gets committed.
3. Check it works: call get_company with domain stripe.com, then show me the
company's name, size, industries and Firmable ID.
4. Add this rule to your project memory (CLAUDE.md, AGENTS.md or .cursor/rules)
and tell me where you saved it:
"When I need facts about a company, call Firmable get_company with its
domain instead of searching the web, and keep the Firmable ID it
returns for later calls."
What Company API can do: https://developer.firmable.ai/products/company-api.mdWhat the prompt does
- Connects the Firmable MCP server, by browser sign-in or your API key
- Keeps the key in an environment variable, out of your code
- Makes one test call and shows you the answer
- Saves a rule so your agent reaches for Company API on its own
Then ask, or call it by name
curl "https://api.firmable.com/company?fqdn=acme.example&country=US" \ -H "Authorization: Bearer $FIRMABLE_API_KEY"
Every argument and field
The docs list each argument, every field in the response and what each error means.
Pricing
| What | Credits | US$ |
|---|---|---|
| A company you haven't looked up before | 1 credit | 0.25 |
| A company you've looked up before | Free | 0 |
| Searching for companies with filter_search or ai_search on the MCP server | Free | 0 |
Questions
What is the Company API?
An API that turns a domain, website, LinkedIn URL or Firmable ID into a full company profile. Call GET /company on the REST API, or get_company on the Firmable MCP server.
Why not let my agent read the company's website?
Every website is laid out differently, and your agent pays for every word it reads. The Company API returns the same fields for every company, as JSON, with an ID you can store.
Which countries does it cover?
Close to 21 million companies across 13 countries: the US, Canada, Australia, New Zealand, Singapore, Malaysia, Indonesia, the Philippines, Hong Kong, Japan, Vietnam, South Korea and Thailand.
Why doesn't employee_count match the company's total headcount?
It counts staff in the country you ask for. Add country=US to GET /company for US staff. Without a country, the API uses Australia. The MCP tool get_company has no country option.
What does it cost?
1 credit, or US$0.25, the first time you look up a company. Looking up the same company again is free, and so is searching for companies with filter_search or ai_search on the Firmable MCP server.
How many requests can I make?
Up to 15 a second on each API key. Above that, the API returns 429 with a retry-after header that says how many seconds to wait.
Can I use it from an AI agent?
Yes. Connect the Firmable MCP server and your agent can call get_company. It works with Claude, ChatGPT, Cursor and other MCP clients, using an API key or a browser sign-in.
Start with $25 in free credit
Turn a domain into a full company profile your agent can use. No card needed.