Launching 1 December: Firmable Data API.Data API launches 1 Dec. Get beta access

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
  • NAICS 488510
  • SIC 4731
  • Rated 4.1 by staff
  • 48,000 web visitors

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
fqdnThe company's domain, such as acme.example
websiteThe full website address
ln_urlThe company's LinkedIn URL
ln_slugThe last part of that URL
idThe Firmable ID from an earlier call
abnThe Australian Business Number, for Australian companies
Country
countryUS, CA, AU, NZ, SG, MY, ID, PH, HK, JP, VN, KR or TH. The default is AU.
Responses
200The company profile.
400The country code isn't supported, or the request is malformed.
429More than 15 requests a second on one key. Wait for the seconds in retry-after.
Read the Company API docs

What teams build with it

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
Your agent callsget_company

Use 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.md
Works in Claude, Cursor, Codex or any agent that can run commands.

What the prompt does

  1. Connects the Firmable MCP server, by browser sign-in or your API key
  2. Keeps the key in an environment variable, out of your code
  3. Makes one test call and shows you the answer
  4. 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"
Add country=US for US data. The default is AU.

Every argument and field

The docs list each argument, every field in the response and what each error means.

Pricing

US$0.25for a new profile
Freeto look it up again
Freeto search for companies
US$25of free credit to start
WhatCreditsUS$
A company you haven't looked up before1 credit0.25
A company you've looked up beforeFree0
Searching for companies with filter_search or ai_search on the MCP serverFree0

One credit costs US$0.25. Full pricing

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.