Enrich Companies (start)

Quota limitation

This endpoint will only accept as many companies to enrich as there is company enrichment and search quota available

Starts bulk enrichment of the provided list of company domains and returns an enrichment ID. The process runs asynchronously and typically takes between 1 and 10 seconds, depending on the number of companies being processed. In order to retrieve the enrichment results, send a request to endpoint GET /v2/companies/enrich/:id.

Looking for Search V1? It’s deprecated, but still available here

Authorization

AuthorizationRequiredBearer <token>

In: header

Request Body

application/jsonRequired

Companies to be enriched

companiesRequiredarray<object>

Companies - List of companies to enrich Each company must have a domain and an optional external ID The domain must be a valid Fully Qualified Domain Name or Hostname

curl -X POST "https://api.surfe.com/v2/companies/enrich" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "companies": [
      {
        "domain": "surfe.com",
        "externalID": "external-id"
      }
    ]
  }'

Enrichment ID

{
  "enrichmentCallbackURL": "https://api.surfe.com/v2/companies/enrich/0195be44-1a0d-718a-967b-042c9d17ffd7",
  "enrichmentID": "0195be44-1a0d-718a-967b-042c9d17ffd7",
  "message": "Your enrichment has started ✨, estimated time: 2 seconds."
}

Enrich Companies (start)

Authorization

Request Body

Response

TypeScript