Enrich People (get)

Quota limitation

Results received from this endpoint count towards the people enrichment quota and will consume credits

Provide an enrichment ID and the endpoint will return the corresponding enrichment's progress. Once it is completed, the response will also include the enrichment results.
The enrichment might take a few seconds to complete, we recommend polling this endpoint around once every second until a status other than IN_PROGRESS is received.

Looking for V1? It’s deprecated, but still available here.
Get single enrichment is deprecated too. You can learn more here.

Authorization

AuthorizationRequiredBearer <token>

In: header

Path Parameters

idRequiredstring

Enrichment ID from where to retrieve the results.

curl -X GET "https://api.surfe.com/v2/people/enrich/<your-enrichment-id>" \
  -H "Authorization: Bearer <token>"

List of enriched people

{
  "companyDomain": "surfe.com",
  "companyName": "Surfe",
  "departments": [
    "Engineering",
    "R&D"
  ],
  "emails": [
    {
      "email": "david.chevalier@surfe.com",
      "validationStatus": "VALID"
    }
  ],
  "externalID": "external-id",
  "firstName": "David",
  "jobTitle": "Co-Founder & CEO",
  "lastName": "Chevalier",
  "linkedInUrl": "https://www.linkedin.com/in/david-maurice-chevalier",
  "mobilePhones": [
    {
      "confidenceScore": 0.8,
      "mobilePhone": "+33 6 12 34 56 78"
    }
  ],
  "seniorities": [
    "Manager",
    "Head"
  ],
  "status": "COMPLETED"
}

Enrich People (get)

Authorization

Path Parameters

Response

TypeScript