Check the status of a bulk contact enrichment job on Clado via MPP.
What it does
The Bulk Contacts Status endpoint is part of the Clado suite of people-search and LinkedIn enrichment APIs, served through the Locus MPP (Micropayment Protocol) gateway. This specific endpoint lets you poll the progress of a previously submitted bulk contact enrichment job by providing its job ID. It returns the current status of the batch operation.
The endpoint accepts a POST request with a required `jobId` field and charges a fixed fee of $0.003 per call (3000 base units of pathUSD on Tempo L2, 6 decimals). Payment is settled via the Tempo method with a one-shot "charge" intent, meaning each request is independently paid for. The broader Clado service includes people search ($0.01/result), deep research ($0.01/result), LinkedIn profile scraping ($0.023), LinkedIn profile enrichment ($0.013), contact enrichment ($0.04–$0.14), bulk contact enrichment ($0.04+/contact), and post-reaction retrieval ($0.013).
Note that the probe did not capture a live 402 challenge from this endpoint (HEAD and GET returned 404), which is expected since the endpoint only accepts POST requests. The OpenAPI spec from the provider confirms the endpoint exists and documents its schema and pricing. External documentation is referenced at https://docs.clado.ai and https://clado.ai.
Capabilities
Use cases
- —Polling the completion status of a bulk LinkedIn contact enrichment batch
- —Monitoring progress of large-scale lead enrichment jobs before downloading results
- —Integrating async bulk enrichment workflows into sales automation pipelines
Fit
Best for
- —Sales teams running bulk LinkedIn contact enrichment
- —Automated lead-gen pipelines that need async job status checks
- —Agents orchestrating multi-step people-search workflows via Clado
Not for
- —Single-contact lookups (use the /clado/contacts endpoint instead)
- —Non-LinkedIn people search or general web scraping
Quick start
curl -X POST https://clado.mpp.paywithlocus.com/clado/bulk-contacts-status \
-H "Content-Type: application/json" \
-d '{"jobId": "your-bulk-job-id"}'Example
Request
{
"jobId": "abc123-bulk-contacts-job"
}Endpoint
Quality
The OpenAPI spec provides clear schema and pricing for this endpoint, but no live 402 challenge was captured (expected since it's POST-only and probed via HEAD/GET). No response examples or detailed documentation were crawled. The referenced docs at docs.clado.ai were not fetched.
Warnings
- —Probe returned 404 on HEAD and GET — endpoint is POST-only; liveness not directly confirmed via 402 challenge
- —No response schema or example response available
- —External docs at https://docs.clado.ai were not crawled; detailed behavior is inferred from OpenAPI spec only
Citations
- —Endpoint charges 3000 base units of pathUSD per call via Tempo method with charge intenthttps://clado.mpp.paywithlocus.com
- —Clado provides people search, LinkedIn enrichment, and deep research for lead generationhttps://clado.mpp.paywithlocus.com
- —API reference docs are at https://docs.clado.aihttps://clado.mpp.paywithlocus.com