{"openapi":"3.1.0","info":{"title":"Apollo via Locus x402","version":"1.0.0","description":"People and company enrichment, lead search, and sales intelligence with 275M+ contacts.","contact":{"email":"api@paywithlocus.com"},"x-guidance":"Use the documented POST operations for Apollo. 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://apollo.x402.paywithlocus.com"}],"x-agentcash-guidance":{"llmsTxtUrl":"https://paywithlocus.com/x402/apollo.md"},"x-service-info":{"categories":["data"],"docs":{"homepage":"https://www.apollo.io","apiReference":"https://docs.apollo.io","llms":"https://paywithlocus.com/x402/apollo.md"}},"paths":{"/apollo/people-enrichment":{"post":{"operationId":"apollo_people_enrichment","summary":"People Enrichment","description":"Find and enrich a person by name, company, email, or LinkedIn URL, returning contact details such as personal emails and phone numbers when requested.","tags":["Data Enrichment"],"security":[],"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.038000","max":"0.318000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.038-$0.318"}},"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":{"first_name":{"type":"string","description":"First name"},"last_name":{"type":"string","description":"Last name"},"email":{"type":"string","description":"Email address"},"linkedin_url":{"type":"string","description":"LinkedIn profile URL"},"organization_name":{"type":"string","description":"Current company name"},"domain":{"type":"string","description":"Current company domain"},"id":{"type":"string","description":"Apollo person ID"},"reveal_personal_emails":{"type":"boolean","description":"Include personal emails in results"},"reveal_phone_number":{"type":"boolean","description":"Include phone numbers (+$0.280)"}},"allOf":[{"description":"At least one identifier is required: email, linkedin_url, id, first_name+last_name, or organization_name/domain","anyOf":[{"required":["email"]},{"required":["linkedin_url"]},{"required":["id"]},{"required":["first_name","last_name"]},{"required":["organization_name"]},{"required":["domain"]}]}],"additionalProperties":true},"example":{"first_name":"Tim","last_name":"Cook","domain":"apple.com"}}}},"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":{"person":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"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"}}}},"/apollo/bulk-people-enrichment":{"post":{"operationId":"apollo_bulk_people_enrichment","summary":"Bulk People Enrichment","description":"Enrich up to 10 people in a single request.","tags":["Data Enrichment"],"security":[],"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.038000","max":"0.318000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.038-$0.318/person"}},"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":{"details":{"description":"Array of person identifiers (max 10). Each object can have: first_name, last_name, email, linkedin_url, organization_name, domain","type":"array","items":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"email":{"type":"string"},"linkedin_url":{"type":"string"},"organization_name":{"type":"string"},"domain":{"type":"string"},"id":{"type":"string"}},"additionalProperties":true},"minItems":1,"maxItems":10},"reveal_phone_number":{"type":"boolean","description":"Include phone numbers for all (+$0.280/person)"},"reveal_personal_emails":{"type":"boolean","description":"Include personal emails for all"}},"required":["details"],"additionalProperties":true},"example":{"details":[{"first_name":"Tim","last_name":"Cook","domain":"apple.com"}],"reveal_phone_number":false,"reveal_personal_emails":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":{"matches":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"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"}}}},"/apollo/org-enrichment":{"post":{"operationId":"apollo_org_enrichment","summary":"Organization Enrichment","description":"Get company data including industry, employee count, funding, revenue, and tech stack.","tags":["Data Enrichment"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.038000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.038"}},"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":{"domain":{"type":"string","description":"Company domain"},"linkedin_url":{"type":"string","description":"Company LinkedIn URL"},"website":{"type":"string","description":"Full company website URL"},"name":{"type":"string","description":"Company name to improve identifier match accuracy"}},"allOf":[{"description":"domain, linkedin_url, or website is required","anyOf":[{"required":["domain"]},{"required":["linkedin_url"]},{"required":["website"]}]}],"additionalProperties":true},"example":{"domain":"apple.com"}}}},"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":{"organization":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"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"}}}},"/apollo/bulk-org-enrichment":{"post":{"operationId":"apollo_bulk_org_enrichment","summary":"Bulk Organization Enrichment","description":"Enrich up to 10 organizations by domain in a single request.","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.038/org"}},"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":{"domains":{"type":"array","items":{"type":"string"},"description":"Array of company domains (max 10), e.g. [\"anthropic.com\", \"openai.com\"]"}},"required":["domains"],"additionalProperties":true},"example":{"domains":["apple.com"]}}}},"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":{"organizations":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"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"}}}},"/apollo/people-search":{"post":{"operationId":"apollo_people_search","summary":"People Search","description":"Search for people by job title, location, company, seniority, and more. Returns profile data but not contact details (use enrichment for emails/phones).","tags":["Data Enrichment"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.005"}},"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":{"q_keywords":{"type":"string","description":"Keywords to search for"},"person_titles":{"type":"array","items":{"type":"string"},"description":"Job titles to filter by"},"person_locations":{"type":"array","items":{"type":"string"},"description":"Locations to filter by"},"q_organization_domains_list":{"type":"array","items":{"type":"string"},"description":"Company domains to filter by"},"organization_ids":{"type":"array","items":{"type":"string"},"description":"Apollo organization IDs to filter by"},"person_seniorities":{"type":"array","items":{"type":"string"},"description":"Seniority levels: founder, c_suite, partner, vp, head, director, manager, senior, entry, intern"},"per_page":{"type":"number","description":"Results per page (max 100, default 25)"},"page":{"type":"number","description":"Page number (max 500)"}},"allOf":[{"description":"At least one search criterion is required: q_keywords, person_titles, person_locations, q_organization_domains_list (alias q_organization_domains), organization_ids, or person_seniorities","anyOf":[{"required":["q_keywords"]},{"required":["person_titles"]},{"required":["person_locations"]},{"required":["q_organization_domains_list"]},{"required":["q_organization_domains"]},{"required":["organization_ids"]},{"required":["person_seniorities"]}]}],"additionalProperties":true},"example":{"q_organization_domains_list":["apple.com"],"per_page":1,"page":1}}}},"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":{"people":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"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"}}}},"/apollo/org-search":{"post":{"operationId":"apollo_org_search","summary":"Organization Search","description":"Search for companies by name, industry, location, size, revenue, and more.","tags":["Data Enrichment"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.038000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.038"}},"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":{"q_organization_domains_list":{"type":"array","items":{"type":"string"},"description":"Company domains to filter by (max 1,000)"},"q_organization_name":{"type":"string","description":"Organization name to search"},"organization_ids":{"type":"array","items":{"type":"string"},"description":"Apollo organization IDs to filter by"},"organization_locations":{"type":"array","items":{"type":"string"},"description":"Locations to filter by"},"q_organization_keyword_tags":{"type":"array","items":{"type":"string"},"description":"Keyword tags to filter by"},"organization_num_employees_ranges":{"type":"array","items":{"type":"string"},"description":"Employee count ranges (e.g., \"1,10\", \"11,50\", \"51,200\")"},"per_page":{"type":"number","description":"Results per page (max 100, default 25)"},"page":{"type":"number","description":"Page number (max 500)"}},"allOf":[{"description":"At least one search criterion is required: q_organization_domains_list, q_organization_name, organization_ids, organization_locations, q_organization_keyword_tags, or organization_num_employees_ranges","anyOf":[{"required":["q_organization_domains_list"]},{"required":["q_organization_name"]},{"required":["organization_ids"]},{"required":["organization_locations"]},{"required":["q_organization_keyword_tags"]},{"required":["organization_num_employees_ranges"]}]}],"additionalProperties":true},"example":{"q_organization_name":"Apple","per_page":1,"page":1}}}},"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":{"accounts":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"},"organization_id":{"type":"string"},"website_url":{"type":"string"},"linkedin_url":{"type":"string"}}}},"organizations":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"type":"string"}}}},"pagination":{"type":"object","additionalProperties":true,"properties":{"page":{"type":"number"},"per_page":{"type":"number"},"total_entries":{"type":"number"},"total_pages":{"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"}}}},"/apollo/job-postings":{"post":{"operationId":"apollo_job_postings","summary":"Organization Job Postings","description":"Get current job postings for a company — useful for identifying hiring signals.","tags":["Data Enrichment"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.038000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.038"}},"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":{"organization_id":{"type":"string","description":"Apollo organization ID"},"page":{"type":"number","description":"Positive page number"},"per_page":{"type":"number","description":"Results per page (max 10,000)"}},"required":["organization_id"],"additionalProperties":true},"example":{"organization_id":"<from apollo/org-enrichment>","page":1,"per_page":1}}}},"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":{"organization_job_postings":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"title":{"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"}}}},"/apollo/news-search":{"post":{"operationId":"apollo_news_search","summary":"News Articles Search","description":"Find recent news articles connected to organizations in Apollo's database. Requires organization IDs (get them from org-search or org-enrichment first).","tags":["Data Enrichment"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.038000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.038"}},"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":{"organization_ids":{"type":"array","items":{"type":"string"},"description":"Apollo organization IDs to find news for"},"categories":{"type":"array","items":{"type":"string"},"description":"News categories such as hires, investment, or contract"},"published_at_min":{"type":"string","description":"Earliest publication date (YYYY-MM-DD)"},"published_at_max":{"type":"string","description":"Latest publication date (YYYY-MM-DD)"},"per_page":{"type":"number","description":"Results per page (max 25)"},"page":{"type":"number","description":"Page number"}},"required":["organization_ids"],"additionalProperties":true},"example":{"organization_ids":["<from apollo/org-enrichment>"],"per_page":1,"page":1}}}},"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":{"news_articles":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"title":{"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"}}}}}}