Hydrant API
Enrichments

Get a batch's progress

How many of its enrichments have ended and how, and a page of its domains with each one's enrichment.

GET
/v1/enrichments/batch/{batch_id}

How many of its enrichments have ended and how, and a page of its domains with each one's enrichment.

Authorization

ApiKey
headerAuthorizationBearer <token>

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

Path Parameters

batch_id*Batch Id

The batch's id.

Query Parameters

limit?Limit

The most items to return.

Range1 <= value <= 1000
Default100
cursor?|

The previous page's next_cursor.

Response Body

Successful Response

application/json
  1. response

A batch of enrichments, one for each distinct domain, and a page of its domains.

id*Id

Its id, to GET /v1/enrichments/batch/{id} by.

status*Status

completed once every enrichment has ended, however each did; failed only if the batch itself did (on our side).

Value in"running""completed""failed"
created_at*Created At
Formatdate-time
finished_at*|null
counts*|

Null while it runs if it couldn't be read just then.

items*array<>

A page of its domains, in the order given.

next_cursor*|

Pass it as cursor for the next page of items. Null on the last page.

status_url*Status Url
webhook_status*|null
Example Request
curl -X GET 'https://api.hydrantapi.com/v1/enrichments/batch/string'
Example Response
{  "id": "bat_cy3tss33c57i2y2j54s23j6cmm",  "status": "completed",  "created_at": "2026-10-05T22:00:22.537731Z",  "finished_at": "2026-10-05T22:05:15.354959Z",  "counts": {    "total": 26,    "pending": 0,    "running": 0,    "succeeded": 26,    "failed": 0  },  "items": [    {      "domain": "southeastemulsions.com",      "enrichment_id": "enr_bvnjslyapfhg33vb27mkmwxlri",      "status": "succeeded",      "company_domain": "southeastemulsions.com",      "entity_id": "701f7a2c-0a5b-4461-aff1-e4c0454c644b",      "error_code": null    },    {      "domain": "yitgroup.com",      "enrichment_id": "enr_wmtzirh6ogvamwzaenzjwh56ki",      "status": "succeeded",      "company_domain": "yitgroup.com",      "entity_id": "6f610fb8-cb8e-442e-9fcc-291fec44258a",      "error_code": null    }  ],  "next_cursor": "eyJvZmZzZXQiOiAyfQ",  "status_url": "/v1/enrichments/batch/bat_cy3tss33c57i2y2j54s23j6cmm",  "webhook_status": "delivered"}

Search companies GET

The stored companies that pass every filter given, a page at a time, in a fixed order. A filter takes several values, comma-separated, and passes a company with any of them. A company we have no value for in a field passes no filter on it.

Get an enrichment GET

While it runs, where it is, how far each source is, and when it should end; once it has ended, the company's record, or why it failed.