{"openapi":"3.1.0","info":{"title":"Clado via Locus x402","version":"1.0.0","description":"Contact enrichment for lead generation, individually or as a bulk job with its own status read.","contact":{"email":"api@paywithlocus.com"},"x-guidance":"Use the documented POST operations for Clado. Send JSON matching each requestBody schema. Unpaid public x402 requests return an x402 v2 payment challenge; retry the same body with PAYMENT-SIGNATURE and the returned x-locus-request-id."},"servers":[{"url":"https://clado.x402.paywithlocus.com"}],"x-agentcash-guidance":{"llmsTxtUrl":"https://paywithlocus.com/x402/clado.md"},"x-service-info":{"categories":["data"],"docs":{"homepage":"https://clado.ai","apiReference":"https://docs.clado.ai","llms":"https://paywithlocus.com/x402/clado.md"}},"paths":{"/clado/contacts":{"post":{"operationId":"clado_contacts","summary":"Contact Enrichment","description":"Get contact info (email, phone) for a person by LinkedIn URL, email, or phone.","tags":["Data Enrichment"],"security":[],"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.040000","max":"0.140000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.04-$0.14"}},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"linkedin_url":{"type":"string","description":"LinkedIn profile URL"},"email":{"type":"string","description":"Email address"},"phone":{"type":"string","description":"Phone number"},"email_enrichment":{"type":"boolean","description":"Enrich email (4 credits)"},"phone_enrichment":{"type":"boolean","description":"Enrich phone (10 credits)"}},"allOf":[{"description":"linkedin_url, email, or phone is required","anyOf":[{"required":["linkedin_url"]},{"required":["email"]},{"required":["phone"]}]}],"additionalProperties":true},"example":{"linkedin_url":"https://www.linkedin.com/in/williamhgates","email_enrichment":true,"phone_enrichment":false}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"object","additionalProperties":true,"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"boolean"},"contacts":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}},"description":"Partial response schema observed in an authenticated, semantically verified customer call. Only observed field types are described; optionality, other inputs and error states are not inferred."},"request":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"statusUrl":{"type":"string"}},"required":["id","statusUrl"],"additionalProperties":false},"payment":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact","upto"]},"authorizedMaxUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"settledUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"capExhausted":{"type":"boolean"},"calculatedActualUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"usage":{}},"required":["scheme","authorizedMaxUsdc","settledUsdc"],"additionalProperties":false}},"required":["success","data","request","payment"],"additionalProperties":false}}}},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/clado/bulk-contacts":{"post":{"operationId":"clado_bulk_contacts","summary":"Bulk Contact Enrichment","description":"Enrich contacts in bulk by LinkedIn URLs or people IDs.","tags":["Data Enrichment"],"security":[],"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.001000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.04+/contact"}},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"linkedin_urls":{"type":"array","items":{"type":"string"},"description":"LinkedIn profile URLs"},"people_ids":{"type":"array","items":{"type":"string"},"description":"People IDs"},"email_enrichment":{"type":"boolean","description":"Enrich emails"},"phone_enrichment":{"type":"boolean","description":"Enrich phones"}},"allOf":[{"description":"linkedin_urls or people_ids is required","anyOf":[{"required":["linkedin_urls"]},{"required":["people_ids"]}]}],"additionalProperties":true},"example":{"linkedin_urls":["https://www.linkedin.com/in/williamhgates"],"email_enrichment":true,"phone_enrichment":false}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"object","additionalProperties":true,"properties":{"job_id":{"type":"string"}},"description":"Partial response schema observed in an authenticated, semantically verified customer call. Only observed field types are described; optionality, other inputs and error states are not inferred."},"request":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"statusUrl":{"type":"string"}},"required":["id","statusUrl"],"additionalProperties":false},"payment":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact","upto"]},"authorizedMaxUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"settledUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"capExhausted":{"type":"boolean"},"calculatedActualUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"usage":{}},"required":["scheme","authorizedMaxUsdc","settledUsdc"],"additionalProperties":false}},"required":["success","data","request","payment"],"additionalProperties":false}}}},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/clado/bulk-contacts-status":{"post":{"operationId":"clado_bulk_contacts_status","summary":"Bulk Contacts Status","description":"Check the status of a bulk contact enrichment job.","tags":["Data Enrichment"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.003 platform fee (upstream free)"}},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string","description":"Bulk contacts job ID"}},"required":["jobId"],"additionalProperties":true},"example":{"jobId":"<from clado/bulk-contacts>"}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"object","additionalProperties":true,"properties":{"results":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"success":{"type":"boolean"},"data":{"type":"object","additionalProperties":true,"properties":{"contacts":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"value":{"type":"string"}}}}}}}}},"status":{"type":"string"},"successful":{"type":"number"},"failed":{"type":"number"}},"description":"Partial response schema observed in an authenticated, semantically verified customer call. Only observed field types are described; optionality, other inputs and error states are not inferred."},"request":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"statusUrl":{"type":"string"}},"required":["id","statusUrl"],"additionalProperties":false},"payment":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact","upto"]},"authorizedMaxUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"settledUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"capExhausted":{"type":"boolean"},"calculatedActualUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"usage":{}},"required":["scheme","authorizedMaxUsdc","settledUsdc"],"additionalProperties":false}},"required":["success","data","request","payment"],"additionalProperties":false}}}},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}}}}