Hydrant API
Companies

Get a company's record, enriching it first if need be

One call for a company's record by its domain. A record we have with something fetched for it in the last 30 days is served as it is, and costs a read. Otherwise the company is enriched now, and the call waits up to 30 s for it: 200 with the record if it ends in time, and costs an enrichment, given back if it finds no company; 202 with the enrichment to follow if not. The key needs the `enrich` scope.

GET
/v1/companies/enrich

One call for a company's record by its domain. A record we have with something fetched for it in the last 30 days is served as it is, and costs a read. Otherwise the company is enriched now, and the call waits up to 30 s for it: 200 with the record if it ends in time, and costs an enrichment, given back if it finds no company; 202 with the enrichment to follow if not. The key needs the enrich scope.

Authorization

ApiKey
headerAuthorizationBearer <token>

An API key from the dashboard: Authorization: Bearer hyd_live_….

Query Parameters

domain*Domain

The company's website's domain or hostname.

fields?|

The fields to return, comma-separated: hq_location, industry, employee_band, founded_year, linkedin_url, name, legal_name, registered_address, incorporated_on, company_status, incorporated_in, listing, description, founders, branches, logos, pricing_plans. Every field if left out. domain, entity_id and resolved_at always come.

include?|

evidence adds, to each value of the record, the statements backing it.

Response Body

Successful Response

application/json
  1. response

A company's resolved record: one value per field, each with how sure we are of it and who says so.

domain*Domain

The company's website's domain, the one it uses now.

entity_id*Entity Id

Our id for the company. It never changes.

Formatuuid
resolved_at*Resolved At

When the record was last worked out.

Formatdate-time
hq_location?|

Where the company is run from. When no source says, its registered office, which sources then shows comes from a register.

industry?|

What the company does.

industries?array<>

Every industry the company could fairly be filed under, up to three, the likeliest first: industry first when there is one, then those the sources back well enough on their own. When industry is null because two industries are too close to call, this still lists them. Comes with industry.

employee_band?|

How many people the company employs.

founded_year?|

The year the company was founded, as it tells it.

linkedin_url?|

The company's LinkedIn page, at its current address.

name?|

The name the company goes by.

legal_name?|

The company's name as registered.

registered_address?|

The company's legal address, as its register has it. Often a registered agent's or an accountant's, so it's hq_location only when no source says where the company is run from.

incorporated_on?|

The day the company was incorporated, as its register has it: not always its founding, which is founded_year.

company_status?|

Whether the company is still trading, as its register says.

incorporated_in?|

Where the company was incorporated.

listing?|

Whether the company's shares trade, and under what ticker.

description?|

What the company does, in a sentence or two.

founders?array<>
branches?array<>

Offices, plants and stores besides the HQ.

logos?array<>
pricing_plans?array<>
Example Request
curl -X GET 'https://api.hydrantapi.com/v1/companies/enrich?domain=hvidbjergbank.dk'
Example Response
{  "domain": "hvidbjergbank.dk",  "entity_id": "bb80e7e2-dd05-48f2-ab65-19f73b16716a",  "resolved_at": "2026-10-01T16:57:36.401113Z",  "hq_location": {    "value": {      "city": "Hvidbjerg",      "region": null,      "country": "DK"    },    "confidence": 0.3424,    "as_of": "2026-09-30T19:57:22.004102Z",    "sources": [      "wikidata"    ]  },  "industry": {    "value": {      "code": 43,      "label": "Financial Services"    },    "confidence": 0.4746,    "as_of": "2026-09-30T19:57:22.004102Z",    "sources": [      "wikidata"    ]  },  "industries": [    {      "value": {        "code": 43,        "label": "Financial Services"      },      "confidence": 0.4746,      "as_of": "2026-09-30T19:57:22.004102Z",      "sources": [        "wikidata"      ]    }  ],  "employee_band": null,  "founded_year": {    "value": 1912,    "confidence": 0.57,    "as_of": "2026-09-30T19:57:22.004102Z",    "sources": [      "wikidata"    ]  },  "linkedin_url": null,  "name": {    "value": "Hvidbjerg Bank",    "confidence": 0.923,    "as_of": "2026-10-01T16:57:23Z",    "sources": [      "wikidata",      "website"    ]  },  "legal_name": {    "value": "HVIDBJERG BANK A/S",    "confidence": 0.9423,    "as_of": "2026-10-01T08:00:00Z",    "sources": [      "gleif",      "wikidata"    ]  },  "registered_address": {    "value": {      "city": "Thyholm",      "region": "DK-82",      "country": "DK"    },    "confidence": 0.866,    "as_of": "2026-10-01T08:00:00Z",    "sources": [      "gleif"    ]  },  "incorporated_on": null,  "company_status": null,  "incorporated_in": null,  "listing": null,  "description": null,  "founders": [],  "branches": [],  "logos": [],  "pricing_plans": []}