{"openapi":"3.1.0","info":{"title":"Agent Verifier API","description":"Bot-native verification endpoints for AI agents with API-key auth and usage metering.","version":"0.2.0"},"paths":{"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Health Get"}}}}}}},"/v1/usage":{"get":{"summary":"Usage","operationId":"usage_v1_usage_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Usage V1 Usage Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verify/url":{"post":{"summary":"Verify Url Endpoint","operationId":"verify_url_endpoint_v1_verify_url_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerificationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verify/json":{"post":{"summary":"Verify Json Endpoint","operationId":"verify_json_endpoint_v1_verify_json_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerificationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verify/email":{"post":{"summary":"Verify Email Endpoint","operationId":"verify_email_endpoint_v1_verify_email_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerificationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verify/business":{"post":{"summary":"Verify Business Endpoint","operationId":"verify_business_endpoint_v1_verify_business_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerificationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verify/claim":{"post":{"summary":"Verify Claim Endpoint","operationId":"verify_claim_endpoint_v1_verify_claim_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerificationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/score-output":{"post":{"summary":"Score Output Endpoint","operationId":"score_output_endpoint_v1_score_output_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutputScoreRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerificationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"BusinessVerifyRequest":{"properties":{"name":{"type":"string","minLength":2,"title":"Name"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"website":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Website"}},"type":"object","required":["name"],"title":"BusinessVerifyRequest"},"ClaimVerifyRequest":{"properties":{"claim":{"type":"string","minLength":5,"title":"Claim"},"source_urls":{"items":{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},"type":"array","maxItems":5,"title":"Source Urls"},"required_confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Required Confidence","default":0.75}},"type":"object","required":["claim"],"title":"ClaimVerifyRequest"},"EmailVerifyRequest":{"properties":{"email":{"type":"string","title":"Email"},"check_dns":{"type":"boolean","title":"Check Dns","default":true}},"type":"object","required":["email"],"title":"EmailVerifyRequest"},"Evidence":{"properties":{"source":{"type":"string","title":"Source"},"quote":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence","default":0.0},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["source"],"title":"Evidence"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"JsonVerifyRequest":{"properties":{"text":{"type":"string","title":"Text"},"required_keys":{"items":{"type":"string"},"type":"array","title":"Required Keys"},"schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Schema"}},"type":"object","required":["text"],"title":"JsonVerifyRequest"},"OutputScoreRequest":{"properties":{"output":{"type":"string","title":"Output"},"expected_format":{"type":"string","enum":["json","markdown","plain"],"title":"Expected Format","default":"plain"},"must_include":{"items":{"type":"string"},"type":"array","title":"Must Include"},"must_not_include":{"items":{"type":"string"},"type":"array","title":"Must Not Include"},"max_length":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Max Length"}},"type":"object","required":["output"],"title":"OutputScoreRequest"},"Recommendation":{"type":"string","enum":["safe_to_use","do_not_use","needs_human_review"],"title":"Recommendation"},"UrlVerifyRequest":{"properties":{"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"require_https":{"type":"boolean","title":"Require Https","default":true},"expected_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Text"},"timeout_seconds":{"type":"number","maximum":30.0,"minimum":1.0,"title":"Timeout Seconds","default":8}},"type":"object","required":["url"],"title":"UrlVerifyRequest"},"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"},"VerificationResponse":{"properties":{"status":{"$ref":"#/components/schemas/VerificationStatus"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"recommendation":{"$ref":"#/components/schemas/Recommendation"},"summary":{"type":"string","title":"Summary"},"evidence":{"items":{"$ref":"#/components/schemas/Evidence"},"type":"array","title":"Evidence"},"machine_readable":{"additionalProperties":true,"type":"object","title":"Machine Readable"}},"type":"object","required":["status","confidence","recommendation","summary"],"title":"VerificationResponse"},"VerificationStatus":{"type":"string","enum":["verified","failed","uncertain"],"title":"VerificationStatus"}}}}