POST/v2/live/person/contact-info

Request contact information

Submit a batch of person contact info enrichment requests. Processing is asynchronous: returns a batch ID and item count; poll GET /person/contact-info/{id} for status and results. Phone numbers are withheld for people resident in Colorado: enrichPhone is ignored for those items, which complete with no phone and no error, and no phone enrichment is billed.

Version
v2Open on v3
Rate limit
Tier 3 · 10–200 rps by plan
Billing
Personal Email or Phone or Work Email · Request contact information

Request body

  • requestsobject[]Optional
    • aggkPersonIdinteger (int64)Optional
    • enrichPersonalEmailbooleanOptional
    • enrichPhonebooleanOptional
    • enrichWorkEmailbooleanOptional
    • metadataobjectOptional
Headers
x-api-key Required · API key for authentication

Response

  • batchIdstring
    Batch UUID for tracking the request
  • itemCountinteger (int32)
    Number of items in the request
  • messagestring
    Status message

Status codes