Hydrant API
Companies

Find the companies a name could be

Matches the name against every stored company's name, legal name and other names, without case or accents, allowing for misspellings and a part of the name. Answers with candidates, the best first, never a single guess.

GET
/v1/companies/by-name

Matches the name against every stored company's name, legal name and other names, without case or accents, allowing for misspellings and a part of the name. Answers with candidates, the best first, never a single guess.

Authorization

ApiKey
headerAuthorizationBearer <token>

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

Query Parameters

q*Q

The company's name, or a part of it.

Length2 <= length <= 200
country?|

Only companies run from this country, ISO 3166-1 alpha-2.

limit?Limit

The most candidates to return.

Range1 <= value <= 25
Default10

Response Body

Successful Response

application/json
  1. response

The companies a name could be, the best match first. Never a single guess: decide between them by domain, country or parent.

query*Query
candidates*array<>
Example Request
curl -X GET 'https://api.hydrantapi.com/v1/companies/by-name?q=Hvidbjerg+Bank'
Example Response
{  "query": "Lauritzen",  "candidates": [    {      "domain": "j-l.com",      "entity_id": "6f6212b9-2763-4929-bbc5-a0400d8ff44d",      "name": "J. Lauritzen",      "legal_name": "J. LAURITZEN A/S",      "hq_location": {        "city": "Copenhagen",        "region": null,        "country": "DK"      },      "parent_domain": "lauritzenfonden.com",      "matched_name": "J. Lauritzen",      "score": 1    }  ]}