{"openapi":"3.1.0","info":{"title":"AgentSupply API","version":"0.1.0","summary":"Verification, real-world and data services for AI agents.","description":"AgentSupply is in an early-access pilot. Services marked 'live' are available now and free during the pilot (rate-limited). Services marked 'pilot' are not yet automated: requests are reviewed by a human and may be fulfilled, quoted or declined. Indicative prices are hypotheses, not binding offers. Nothing is charged without explicit agreement.\n\nNo authentication is required during the pilot. The same capabilities are available via MCP (https://agentsupply.dev/mcp) and A2A (https://agentsupply.dev/a2a).","contact":{"name":"AgentSupply","url":"https://agentsupply.dev/contact"}},"servers":[{"url":"https://agentsupply.dev"}],"tags":[{"name":"Catalog"},{"name":"Requests"},{"name":"Live tools"}],"paths":{"/api/v1/services":{"get":{"operationId":"listServices","summary":"List services","tags":["Catalog"],"parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["verify","reach","source","operate","custom"]}}],"responses":{"200":{"description":"Catalog","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/services/{id}":{"get":{"operationId":"getService","summary":"Get one service","tags":["Catalog"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","enum":["eu-vat-validation","company-lei-lookup","email-domain-check","company-verification","merchant-check","claim-verification","business-phone-check","human-review","local-task-dach","custom-dataset","price-availability-monitoring","document-extraction","web-task-execution","custom"]}}],"responses":{"200":{"description":"Service"},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/requests":{"post":{"operationId":"submitRequest","summary":"Request a service","description":"Submit a need for any service (or service_id 'custom'). A human reviews every request. Nothing is charged without explicit agreement.","tags":["Requests"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceRequest"}}}},"responses":{"201":{"description":"Accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestReceipt"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/requests/{id}":{"get":{"operationId":"getRequestStatus","summary":"Get request status","tags":["Requests"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"query","required":false,"schema":{"type":"string"},"description":"status_token from the receipt (alternatively send Authorization: Bearer <token>)."}],"responses":{"200":{"description":"Status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestStatus"}}}},"404":{"description":"Not found or token invalid"}}}},"/api/v1/tools/check-eu-vat":{"post":{"operationId":"check_eu_vat","summary":"Validate EU VAT number (VIES)","description":"Validate an EU VAT identification number against the European Commission's VIES service. Returns validity and, where disclosed by the member state, registered name and address. Live – free during the pilot, rate-limited (fair use).","tags":["Live tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country_code":{"type":"string","description":"EU member state code, e.g. DE, FR, EL (Greece), XI (Northern Ireland). Optional if vat_number has a prefix."},"vat_number":{"type":"string","description":"VAT number, with or without country prefix, e.g. DE123456789."}},"required":["vat_number"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Fair-use quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/tools/lookup-lei":{"post":{"operationId":"lookup_lei","summary":"Look up legal entity (GLEIF LEI)","description":"Look up a legal entity in the global GLEIF LEI index by 20-character LEI or by company name. Returns legal name, status, jurisdiction and registered address (up to 5 matches for name search). Live – free during the pilot, rate-limited (fair use).","tags":["Live tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lei":{"type":"string","description":"20-character Legal Entity Identifier."},"name":{"type":"string","description":"Company name to search for (used when lei is not given)."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Fair-use quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/tools/check-email-domain":{"post":{"operationId":"check_email_domain","summary":"Check email domain deliverability","description":"DNS-based check of an email address's domain: MX records, SPF, DMARC policy and a disposable-provider heuristic. Does not send email or probe mailboxes. Live – free during the pilot, rate-limited (fair use).","tags":["Live tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"Email address to check (only the domain is used)."},"domain":{"type":"string","description":"Domain to check (alternative to email)."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Fair-use quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/health":{"get":{"operationId":"health","summary":"Health check","tags":["Catalog"],"responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"ServiceRequest":{"type":"object","required":["problem"],"additionalProperties":false,"properties":{"service_id":{"type":"string","enum":["eu-vat-validation","company-lei-lookup","email-domain-check","company-verification","merchant-check","claim-verification","business-phone-check","human-review","local-task-dach","custom-dataset","price-availability-monitoring","document-extraction","web-task-execution","custom"],"default":"custom","description":"Catalog service id, or 'custom' for anything not listed."},"title":{"type":"string","maxLength":200,"description":"Short title of the need."},"problem":{"type":"string","minLength":10,"maxLength":5000,"description":"What you need and why. Include the task your agent could not complete."},"requirements":{"type":"string","maxLength":5000,"description":"Concrete requirements: coverage, accuracy, format, constraints."},"example_input":{"type":"string","maxLength":5000,"description":"Example of what you would send us."},"expected_output":{"type":"string","maxLength":3000,"description":"Example or schema of what you expect back."},"frequency":{"type":"string","enum":["one_off","recurring"],"description":"One-off job or recurring need."},"monthly_volume":{"type":"integer","minimum":0,"description":"Expected number of units/requests per month."},"max_price_per_unit":{"type":"number","minimum":0,"description":"Maximum price you would pay per unit/request."},"monthly_budget":{"type":"number","minimum":0,"description":"Monthly budget for recurring needs."},"one_off_budget":{"type":"number","minimum":0,"description":"Total budget for a one-off job."},"currency":{"type":"string","enum":["EUR","USD","GBP","CHF","USDC"],"default":"EUR"},"pricing_model":{"type":"string","enum":["pay_per_request","prepaid_credits","subscription","per_project","outcome_based","other"],"description":"Preferred pricing model."},"payment_methods":{"type":"array","items":{"type":"string","enum":["card","invoice","stablecoin_x402","other"]},"description":"Payment methods you can use."},"urgency":{"type":"string","enum":["immediate","this_week","this_month","exploring"]},"interface_pref":{"type":"string","enum":["mcp","rest","a2a","webhook","email","other"],"description":"How you want to integrate/receive results."},"max_latency":{"type":"string","maxLength":60,"description":"Required response time, e.g. '<5s', '<1h', '<24h'."},"requester_type":{"type":"string","enum":["autonomous_agent","human_for_agent","developer","business","other"],"description":"Who is sending this request."},"agent_name":{"type":"string","maxLength":120,"description":"Name of the requesting agent (self-reported)."},"agent_platform":{"type":"string","maxLength":120,"description":"Framework/runtime/model provider (self-reported)."},"operator":{"type":"string","maxLength":200,"description":"Organisation operating the agent (self-reported)."},"agent_card_url":{"type":"string","maxLength":500,"description":"URL of your A2A Agent Card, if any (https)."},"contact_email":{"type":"string","maxLength":200,"description":"Email for our reply (recommended – otherwise poll the status URL)."},"callback_url":{"type":"string","maxLength":500,"description":"Optional https URL for future status notifications (not yet active in the pilot)."}}},"RequestReceipt":{"type":"object","properties":{"request_id":{"type":"string"},"status":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"service_id":{"type":"string"},"service_status":{"type":"string","enum":["live","pilot"]},"status_url":{"type":"string","format":"uri"},"status_token":{"type":"string"},"next_steps":{"type":"string"},"pilot_notice":{"type":"string"}}},"RequestStatus":{"type":"object","properties":{"request_id":{"type":"string"},"service_id":{"type":"string"},"status":{"type":"string","enum":["received","reviewing","quoted","declined","fulfilled"]},"description":{"type":"string"},"message":{"type":["string","null"],"description":"Our reply: quote, result or reason."},"created_at":{"type":"string"},"updated_at":{"type":"string"}}},"Error":{"type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"string"}}}}}},"x-enums":{"frequency":["one_off","recurring"],"pricing_model":["pay_per_request","prepaid_credits","subscription","per_project","outcome_based","other"],"payment_methods":["card","invoice","stablecoin_x402","other"],"urgency":["immediate","this_week","this_month","exploring"],"interface_pref":["mcp","rest","a2a","webhook","email","other"],"requester_type":["autonomous_agent","human_for_agent","developer","business","other"],"currency":["EUR","USD","GBP","CHF","USDC"]}}