Skip to content
Company & B2B

Company Firmographics

Industry codes, headcount, revenue band and growth for a company domain.

POST/v1/company-firmographics
75 credits / matchBulk supportedGlobal
Request
curl -X POST https://api.1lookup.dev/v1/company-firmographics \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com"}'
Response
{
  "success": true,
  "data": {
    "matched": true,
    "domain": "example.com",
    "legal_name": "Northwind Logistics, Inc.",
    "industry": {
      "name": "Freight transportation arrangement",
      "sic": "4731",
      "naics": "488510"
    },
    "employees": {
      "count": 184,
      "band": "51-200",
      "growth_12m_pct": 12.4
    },
    "revenue_band": "$25M-$50M",
    "headquarters": {
      "city": "Columbus",
      "state": "OH",
      "country": "US"
    },
    "founded_year": 2011
  },
  "meta": {
    "credits_used": 75,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}

Authorization

Authorizationstring<bearer>required

Your API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.

Body

Send the fields as a JSON object with Content-Type: application/json.

domainstring<domain>required

Domain. The company's primary website domain. Example: example.com

freshboolean

Skip the 7-day cache and run a new lookup. Charged as a normal lookup.

referencestring

Your own identifier, echoed back in meta and shown in lookup history.

Response

A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.

successboolean

true when the lookup ran.

data.legal_namestring

The registered name of the company behind the domain.

data.industry.sicstring

The four-digit Standard Industrial Classification code.

data.industry.naicsstring

The six-digit North American Industry Classification System code.

data.employees.countnumber

Estimated number of employees, with the size band it falls into.

data.employees.growth_12m_pctnumber

Percentage change in employees over the past 12 months. Negative means the company shrank.

data.revenue_bandstring

Estimated annual revenue as a range, not a single figure.

data.headquartersobject

City, state or region, and country of the head office.

data.founded_yearnumber

The year the company was founded.

meta.credits_usednumber

Credits charged for this call.

meta.credits_remainingnumber

Your balance after the call.

meta.cachedboolean

true when the result came from the 7-day cache.

meta.request_idstring

Quote this when you contact support.

Errors

A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.

HTTPCodeMeaning
401unauthorizedThe key is missing, malformed or revoked.
402insufficient_creditsYour credits are used up and pay as you go is off or at its limit.
422invalid_inputA field is missing or malformed. The field property names it.
429rate_limitedToo many requests for this key. Wait for the Retry-After interval.
500internal_errorSomething failed on our side. Safe to retry.
503source_unavailableAn upstream source did not answer in time. Safe to retry.

Billing

75 credits / match. Charged only when a match is found. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge.

Product overview and use cases