{"openapi":"3.1.0","info":{"title":"MDataAccess API","summary":"Machine-native data access for autonomous AI agents.","description":"\nMDataAccess provides autonomous agents with simple pay-per-request access\nto external data services.\n\n## Payments\n\nPaid endpoints use the x402 protocol.\n\nCurrent environment:\n\n- Network: Base mainnet\n- Payment asset: USDC\n- Authentication: x402 payment\n- API subscription: not required\n- MDataAccess API key: not required\n\n## Agent workflow\n\n1. Call an endpoint.\n2. Receive HTTP 402 Payment Required.\n3. Complete the x402 payment.\n4. Retry/complete the request with payment authorization.\n5. Receive JSON data.\n\nThis deployment is live on Base mainnet and uses real USDC payments.\n\n## Choosing an endpoint\n\n- Use /read when you already have a webpage URL and need its readable text.\n- Use /company when you know a company name or domain and want enrichment.\n- Use /companies/search when you need to find a company from search criteria expressed as PDL SQL.\n- Use /person when you know a person's email, LinkedIn URL, or name and want enrichment.\n- Use /people/search when you need to find a person from search criteria expressed as PDL SQL.\n- Use /decision-makers when you know the company and business function and want one senior decision-maker without writing a search query.\n- Use /lead when you know the company and target function and want one compact sales-ready lead selected automatically.\n","contact":{"name":"MDataAccess","url":"https://mdataaccess.com/","email":"info@mdataaccess.com"},"license":{"name":"Proprietary"},"version":"0.17.0"},"paths":{"/health":{"get":{"tags":["System"],"summary":"Check API health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/pricing":{"get":{"tags":["Discovery"],"summary":"Machine-readable endpoint pricing","operationId":"pricing_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/services":{"get":{"tags":["Discovery"],"summary":"List services available to agents","operationId":"services_services_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/read":{"get":{"tags":["Web"],"summary":"Read web content","description":"Use when you already have a webpage URL and need its readable text. x402 price: $0.002.","operationId":"read_read_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","description":"URL of the webpage to retrieve.","examples":["https://example.com"],"title":"Url"},"description":"URL of the webpage to retrieve."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/search":{"get":{"tags":["Enrichment"],"summary":"Search for a company","description":"Use when the company is not already known and you need to find one using custom PDL SQL search criteria. Exactly one company is returned per paid call. x402 price: $0.15.","operationId":"companies_search_companies_search_get","parameters":[{"name":"sql","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":4000,"description":"PDL Company Search SQL query.","examples":["SELECT * FROM company WHERE name = 'google'"],"title":"Sql"},"description":"PDL Company Search SQL query."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrichmentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/decision-makers":{"get":{"tags":["Intelligence"],"summary":"Find a company decision-maker","description":"Use when you know the company and business function and want one senior decision-maker. MDataAccess constructs the underlying person search automatically, so no SQL is required. x402 price: $0.45.","operationId":"decision_makers_decision_makers_get","parameters":[{"name":"company","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"description":"Company name.","examples":["google"],"title":"Company"},"description":"Company name."},{"name":"function","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"description":"Business function or department.","examples":["engineering"],"title":"Function"},"description":"Business function or department."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrichmentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lead":{"get":{"tags":["Intelligence"],"summary":"Find a sales-ready lead","description":"Use when you know the company and target business function and want one compact sales-ready lead. MDataAccess applies targeting logic automatically, so no SQL is required. x402 price: $0.49.","operationId":"lead_lead_get","parameters":[{"name":"company","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"description":"Company name.","examples":["google"],"title":"Company"},"description":"Company name."},{"name":"function","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"description":"Target business function or department.","examples":["engineering"],"title":"Function"},"description":"Target business function or department."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrichmentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/people/search":{"get":{"tags":["Enrichment"],"summary":"Search for a person","description":"Use when the person is not already known and you need to find one using custom PDL SQL search criteria. Exactly one profile is returned per paid call. x402 price: $0.35.","operationId":"people_search_people_search_get","parameters":[{"name":"sql","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":4000,"description":"PDL Person Search SQL query.","examples":["SELECT * FROM person WHERE job_title = 'software engineer'"],"title":"Sql"},"description":"PDL Person Search SQL query."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrichmentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/person":{"get":{"tags":["Enrichment"],"summary":"Enrich a person","description":"Use when you already know a person and want enrichment data. Provide an email, LinkedIn URL, or name. x402 price: $0.35.","operationId":"person_person_get","parameters":[{"name":"email","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Person email address.","examples":["person@example.com"],"title":"Email"},"description":"Person email address."},{"name":"linkedin_url","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Public LinkedIn profile URL.","title":"Linkedin Url"},"description":"Public LinkedIn profile URL."},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Person's full name.","examples":["Jane Smith"],"title":"Name"},"description":"Person's full name."},{"name":"company","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Company name used to improve matching.","examples":["Example Inc"],"title":"Company"},"description":"Company name used to improve matching."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrichmentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/company":{"get":{"tags":["Enrichment"],"summary":"Enrich a company","description":"Use when you already know a company and want enrichment data using its name or website. x402 price: $0.15.","operationId":"company_company_get","parameters":[{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Company name.","examples":["OpenAI"],"title":"Name"},"description":"Company name."},{"name":"website","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Company website/domain.","examples":["openai.com"],"title":"Website"},"description":"Company website/domain."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrichmentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"EnrichmentResponse":{"properties":{"provider":{"type":"string","title":"Provider"},"data":{"additionalProperties":true,"type":"object","title":"Data"}},"type":"object","required":["provider","data"],"title":"EnrichmentResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ReadResponse":{"properties":{"provider":{"type":"string","title":"Provider"},"url":{"type":"string","title":"Url"},"results":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Results"}},"type":"object","required":["provider","url","results"],"title":"ReadResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}