# Company API

> 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.

- Web page: https://developer.firmable.ai/products/company-api
- Get a free API key: https://platform.firmable.com/sign-up
- Docs: https://docs.firmable.com/api-reference/overview/api-reference/endpoint/company-get
- Full API reference: https://docs.firmable.com/api-reference/overview

## What you can do

- Prefill sign-up and onboarding forms
- Enrich every account in your CRM
- Give your agent the facts before it acts

Key facts: Close to 21M companies, 13 countries, US$0.25 a profile, charged once.

## How it works

1. **Send one identifier.** A domain, website, LinkedIn URL or Firmable ID. Add country for that country's data.
2. **Get the profile.** Size, type, industry, locations and contact details, as JSON.
3. **Look it up again for free.** You pay once for each company. Later lookups are free.

Fields in every response:

- `id`: The Firmable ID, used by every other call.
- `employee_count, company_size`: Staff in the country you asked for, and the size band.
- `industries, industry_codes`: Industries, with NAICS and SIC codes where available.
- `hq_location, locations`: The head office and other locations.
- `phones, emails, social_media`: The company's contact details and social profiles.
- `nextGen`: Web traffic and employee review ratings.

## 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

### Product teams: prefill sign-up forms

1. Take the domain from the sign-up email.
2. Look the company up.
3. Fill in its name, size and industry for the user.

Tools: `get_company`.

### Revenue operations teams: enrich new CRM accounts

1. Look up each new account by domain.
2. Write size, industry and location to the record.
3. Route it to the right territory.

Tools: `get_company`.

### Sales teams: build target account lists

1. Find companies by industry, size and location.
2. Pull full profiles for the ones you keep.
3. Give reps a list with the details filled in.

Tools: `filter_search`, `get_company`.

### Risk and onboarding teams: check a business before you approve it

1. Look the applicant up by website.
2. Compare its industry with what it declared.
3. Send any mismatch for review.

Tools: `get_company`, `offers_service`.

### Marketing teams: segment by company profile

1. Enrich the campaign list.
2. Split it by size, industry and country.
3. Send each segment its own message.

Tools: `get_company`.

### Agent builders: ground an agent in company facts

1. Give the agent the get_company tool.
2. Let it look up any company it meets.
3. Answer from the profile, not the open web.

Tools: `get_company`.

## Use it in your agent

Paste this into your agent to connect Firmable, make a test call and save a rule for when to use it:

```text
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.md
```

### REST

```text
curl "https://api.firmable.com/company?fqdn=acme.example&country=US" \
  -H "Authorization: Bearer $FIRMABLE_API_KEY"
```

Add country=US for US data. The default is AU.

### MCP

```json
{
  "name": "get_company",
  "arguments": { "domain": "acme.example" }
}
```

Send domain, id or linkedinUrn. This tool has no country option: for US staff numbers and locations, use the REST API with country=US.

### Ask your agent

```text
Use Firmable to look up these 20 domains.
For each, give me the size band, industry, head office and Firmable ID.
```

Works in any client with the Firmable MCP server.

## 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 |

One credit costs US$0.25.

## 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.
