---
title: "Get company firmographic data"
method: GET
path: "/api/v1/enrichment/firmographic"
tags: ["Enrichment"]
---

# Get company firmographic data

`GET /api/v1/enrichment/firmographic`

## Request

- Base URL: `https://api.rodz.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rodz.io/api/v1/enrichment/firmographic`
- Auth: HTTP bearer

Enrich your database with company intelligence — find out company size, industry, location, specialties, and key details by domain, company name, or LinkedIn URL.

**Input:** one or more company identifiers (`domain`, `companyName`, `companyLinkedinUrl`).

**Output:** structured company data (`data.company.firmographics`) including name, website, LinkedIn URL, employee count range, industry, specialties, headquarters location and postal details, founding year, company description, logo URL, and all known office locations. Returned synchronously in a single request.

## Query parameters

- `domain` string, nullable: Company domain (e.g. google.com)
- `companyName` string, nullable: Company name
- `companyLinkedinUrl` string, nullable: Company LinkedIn URL

## Response `200`

Company firmographics (`data.company.firmographics`).

- object: Typed response for the company firmographic endpoint.
  - `data` object, nullable: Firmographic payload, or null if the company was not found
    - `company` object, nullable
      - `companySearch` string, nullable: The lookup value that was resolved (domain, name, or URL)
      - `firmographics` object, nullable
        - `name` string, nullable
        - `website` string, nullable
        - `linkedinUrl` string, nullable
        - `industries` string, nullable: Primary industry classification
        - `specialties` string, nullable: Comma-separated list of specialties
        - `specialtiesList` object[], nullable: List of specialty objects, each {"value": <str>}. The wrapper is intentional and stable — map `.value` if you want a flat string list.
          - `value` string, nullable
        - `companySize` string, nullable: Employee count range, one of: Self-employed, 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+
        - `employeesNumLinkedin` string, nullable: Reported employee count as a string
        - `type` string, nullable: Company type, one of: Privately Held, Public Company, Non Profit, Government Agency, Partnership, Self-Employed, Self-Owned, Educational Institution
        - `founded` string, nullable: Founding year, e.g. "2018"
        - `headquarters` string, nullable: Full HQ address on one line
        - `countryCode` string, nullable: ISO-3166 alpha-2 country code, e.g. "FR"
        - `HQcity` string, nullable
        - `HQcountry` string, nullable
        - `HQstate` string, nullable
        - `HQpostalCode` string, nullable
        - `additionalInfo` string, nullable
        - `countriesImplementation` string, nullable: Comma-separated country codes where the company operates
        - `aboutUs` string, nullable: Company description
        - `slogan` string, nullable: Company tagline
        - `socialFollowers` integer, nullable: Social follower count
        - `imageUrl` string, nullable: Company logo URL
        - `locations` object[], nullable: All known office locations
          - `State` string, nullable
          - `City` string, nullable
          - `Street` string, nullable
          - `PostalCode` string, nullable
          - `AdditionalInfo` string, nullable
          - `Description` string, nullable: Office label, e.g. "Headquarters", "Office"
          - `Headquarter` boolean, nullable: True if this location is the head office
        - `HQphoneNumber` string, nullable: Head-office phone number, **always a string** — `""` when the company has none. An extension, when the source provides one, is appended as `"01 23 45 67 89 ext. 12"`. Until 2026-08-11 this field returned a raw object for companies that had a phone and an empty string for those that did not, so its type varied with the data; it is now flattened.
        - `linkedinId` string, nullable: Numeric LinkedIn company identifier
        - `numberOfLocation` integer, nullable: Count of known office locations
        - `crunchbaseUrl` string, nullable: Public funding-profile URL for the company, when known
  - `requestId` string, nullable: Unique request identifier

## Other responses

- `400`: No search parameter supplied — provide at least one.
- `429`: Rate limit exceeded. Retry after the number of seconds in the `Retry-After` response header.

---

[API](https://skmtc.dev/rodz/apis/rodz-api.md) · [All operations](https://skmtc.dev/rodz/apis/rodz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rodz/apis/rodz-api/revisions/3003505ff896?raw)