GET/v3/live/contact-info/{id}

Get contact data batch status

Returns the status of a contact data batch

Version: v3Open on v2
Rate limit: Tier 4 · 10–500 rps by plan
Billing: Personal Email or Phone or Work Email or Healthcare contact · Get contact data batch status

Path parameters

idstringRequired
Batch UUID

Headers: x-api-key Required · API key for authentication

Response

completedItemsinteger (int32)
Number of completed items
failedItemsinteger (int32)
Number of failed items
idstring
Batch UUID
itemsobject[]
List of contact data items
statusenum ContactDataBatchStatus
Batch status, from how many items have finished
totalItemsinteger (int32)
Total number of items in the batch

Status codes

Response

Example

{
  "completedItems": 45,
  "failedItems": 5,
  "id": "2db5ea61-1752-42cf-8ea1-ab1da060cd0a",
  "items": [
    {
      "aggkPersonId": "590654273",
      "status": "completed",
      "enrichWorkEmail": true,
      "enrichPersonalEmail": false,
      "enrichPhone": true,
      "mostProbableWorkEmail": "dan.entrup@example.com",
      "mostProbableWorkEmailStatus": "HIGH_PROBABILITY",
      "mostProbablePersonalEmail": "dan.entrup@example.org",
      "mostProbablePersonalEmailStatus": "HIGH_PROBABILITY",
      "mostProbablePhone": "+1 555-1234",
      "metadata": {}
    }
  ],
  "status": "completed",
  "totalItems": 50
}