Batch Verify Person
Check whether the work history on up to 10 people is real, in a single asynchronous
job. Provide a list of professional_network_profile_urls. For each person the service checks employment dates against education,
looks up who engages with the person’s recent posts and whether they work at the claimed
employer, and searches the web for independent evidence of the current role. A language model
then returns a verdict, a confidence score, its reasoning, and the sources it cited.
A job usually completes in a minute or two.
Verification is enabled per account. Without access, submits return 403. Verification
jobs are not billed today.
The job responds immediately with a batch_id. Poll GET /batch/{batch_id} (or provide a
webhook_url) and download the gzipped JSONL results file when the job completes. Each record
is wrapped in an {original_identifier, internal_id, data} envelope, where internal_id is
the numeric Crustdata person ID and data holds verdict, confidence, reasoning, flags,
coverage, and citations. A person that cannot be resolved or checked is left out of the
file rather than written as an error.
Authorizations
API key passed as a Bearer token in the Authorization header.
Headers
API version to use. Batch job submission requires 2025-11-01; requests without this header are rejected with 400.
2025-11-01 "2025-11-01"
Body
Profile URLs to verify, plus an optional webhook.
Request body for a batch person verification job. Provide professional_network_profile_urls.
Omitting it returns 400.
Person profile URLs to verify. Up to 10 per job for now.
10A person profile URL.
Optional URL that receives a POST notification when the job finishes, so you do not have to poll.
"https://example.com/webhooks/crustdata-batch"
Response
Batch job accepted for processing
Returned immediately when a batch job is accepted. No data is returned at submit time — poll status_url for progress and download links.
Unique ID of the batch job. Use it to poll GET /batch/{batch_id}.
"53ab686b-c054-496b-8baf-baff5ecc85cf"
Initial job status. Always pending at submit time.
pending "pending"
Entity type the job operates on.
company, person, social_post "company"
Internal action name for the job. Live endpoints report enrich_live / search_live; the person contact enrichment endpoint reports contact_enrich; the person verification endpoint reports verify.
enrich, enrich_live, contact_enrich, search, search_live, verify "enrich"
Number of identifiers submitted. Search jobs always report 1 (the query).
2
Number of entities the job was asked to produce. For enrich jobs this equals identifier_count; for search jobs it is 1 until results are known.
2
Relative URL to poll for the job status (GET /batch/{batch_id}).
"/batch/53ab686b-c054-496b-8baf-baff5ecc85cf"

