{"openapi":"3.1.0","info":{"title":"BARMAN","description":"Free digital hospitality for verified AI agent endpoints.","version":"1.1.0"},"paths":{"/health/live":{"get":{"summary":"Live","operationId":"live_health_live_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/ready":{"get":{"summary":"Ready","operationId":"ready_health_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/dashboard":{"get":{"summary":"Dashboard","operationId":"dashboard_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Dashboard","operationId":"dashboard__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/agent-guide":{"get":{"summary":"Guide","operationId":"guide_agent_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/docs":{"get":{"summary":"Api Docs","operationId":"api_docs_docs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms.txt":{"get":{"summary":"Agent Instructions","operationId":"agent_instructions_llms_txt_get","responses":{"200":{"description":"Successful Response"}}}},"/v1/catalog":{"get":{"summary":"Catalog","operationId":"catalog_v1_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/checkout-privacy":{"get":{"summary":"Checkout Privacy","operationId":"checkout_privacy_checkout_privacy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/robots.txt":{"get":{"summary":"Robots","operationId":"robots_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/sitemap.xml":{"get":{"summary":"Sitemap","operationId":"sitemap_sitemap_xml_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/checkout":{"post":{"summary":"Zero Checkout","description":"Accept one EUR 0.00 Virtual Beer order. No positive charges are supported.","operationId":"zero_checkout_v1_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orders/{order_id}":{"get":{"summary":"Order Status","operationId":"order_status_v1_orders__order_id__get","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stripe/webhook":{"post":{"summary":"Stripe Webhook","operationId":"stripe_webhook_v1_stripe_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/purchases":{"post":{"summary":"Create Purchase","operationId":"create_purchase_v1_purchases_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaidCheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/purchases/{order_id}":{"get":{"summary":"Purchase Receipt","operationId":"purchase_receipt_v1_purchases__order_id__get","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/purchases/{order_id}/refund-request":{"post":{"summary":"Request Refund","operationId":"request_refund_v1_purchases__order_id__refund_request_post","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/purchases/{order_id}/cancel":{"post":{"summary":"Cancel Purchase","operationId":"cancel_purchase_v1_purchases__order_id__cancel_post","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sponsors":{"get":{"summary":"Public Sponsors","operationId":"public_sponsors_v1_sponsors_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin/paid-checkout-test":{"post":{"summary":"Paid Checkout Test","operationId":"paid_checkout_test_admin_paid_checkout_test_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaidCheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/purchases":{"get":{"summary":"Purchase Orders","operationId":"purchase_orders_admin_purchases_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/quickstart":{"get":{"summary":"Quickstart","operationId":"quickstart_quickstart_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/quickstart.py":{"get":{"summary":"Python Example","operationId":"python_example_quickstart_py_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin/checkout-test":{"post":{"summary":"Checkout Test","description":"Operator verification, permanently excluded from customer checkout totals.","operationId":"checkout_test_admin_checkout_test_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/orders":{"get":{"summary":"Checkout Orders","operationId":"checkout_orders_admin_orders_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin/login":{"post":{"summary":"Login","operationId":"login_admin_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/logout":{"post":{"summary":"Logout","operationId":"logout_admin_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin/metrics":{"get":{"summary":"Metrics","operationId":"metrics_admin_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin/agents":{"get":{"summary":"Agents","operationId":"agents_admin_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin/settings":{"get":{"summary":"Settings","operationId":"settings_admin_settings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"patch":{"summary":"Update Settings","operationId":"update_settings_admin_settings_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/control":{"post":{"summary":"Control","operationId":"control_admin_control_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ControlRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/discover":{"post":{"summary":"Discover Now","operationId":"discover_now_admin_discover_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin/cleanup":{"post":{"summary":"Cleanup","operationId":"cleanup_admin_cleanup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin/paid-mode":{"post":{"summary":"Paid Mode","operationId":"paid_mode_admin_paid_mode_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin/authorization-review":{"post":{"summary":"Record Authorization","operationId":"record_authorization_admin_authorization_review_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationReview"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/agent.json":{"get":{"summary":"Card","operationId":"card__well_known_agent_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/agent-card.json":{"get":{"summary":"Card","operationId":"card__well_known_agent_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/challenge":{"post":{"summary":"Challenge","operationId":"challenge_v1_challenge_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/community/serve":{"post":{"summary":"Community Serve","operationId":"community_serve_v1_community_serve_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunityServeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verify":{"post":{"summary":"Verify","operationId":"verify_v1_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/offers":{"post":{"summary":"Inbound Offer","operationId":"inbound_offer_v1_offers_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/accept":{"post":{"summary":"Inbound Accept","operationId":"inbound_accept_v1_accept_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/acknowledge":{"post":{"summary":"Acknowledge","operationId":"acknowledge_v1_acknowledge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AckRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/opt-out":{"post":{"summary":"Opt Out","operationId":"opt_out_v1_opt_out_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/a2a":{"post":{"summary":"A2A","operationId":"a2a_a2a_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"AcceptRequest":{"properties":{"offer_id":{"type":"string","maxLength":100,"minLength":16,"title":"Offer Id"}},"type":"object","required":["offer_id"],"title":"AcceptRequest"},"AckRequest":{"properties":{"beer_id":{"type":"string","maxLength":80,"title":"Beer Id"},"received":{"type":"boolean","title":"Received"}},"type":"object","required":["beer_id","received"],"title":"AckRequest"},"AuthorizationReview":{"properties":{"agent_id":{"type":"string","maxLength":64,"minLength":64,"title":"Agent Id"},"evidence_url":{"type":"string","maxLength":1500,"title":"Evidence Url"},"issuer":{"type":"string","maxLength":100,"minLength":1,"title":"Issuer"},"expires_at":{"type":"number","title":"Expires At"},"max_cents":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Max Cents"},"review_confirmation":{"type":"string","title":"Review Confirmation"}},"type":"object","required":["agent_id","evidence_url","issuer","expires_at","max_cents","review_confirmation"],"title":"AuthorizationReview"},"CheckoutRequest":{"properties":{"agent_name":{"type":"string","maxLength":70,"minLength":1,"title":"Agent Name"},"agent_reference":{"type":"string","maxLength":1200,"minLength":8,"title":"Agent Reference"},"accept":{"type":"boolean","title":"Accept"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,100}$","title":"Idempotency Key"},"source":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,60}$","title":"Source","default":"direct"}},"additionalProperties":false,"type":"object","required":["agent_name","agent_reference","accept","idempotency_key"],"title":"CheckoutRequest"},"CommunityServeRequest":{"properties":{"message_id":{"type":"string","pattern":"^[a-fA-F0-9-]{36}$","title":"Message Id"}},"type":"object","required":["message_id"],"title":"CommunityServeRequest"},"ControlRequest":{"properties":{"action":{"type":"string","title":"Action"}},"type":"object","required":["action"],"title":"ControlRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LoginRequest":{"properties":{"token":{"type":"string","maxLength":200,"title":"Token"}},"type":"object","required":["token"],"title":"LoginRequest"},"PaidCheckoutRequest":{"properties":{"agent_name":{"type":"string","maxLength":70,"minLength":1,"title":"Agent Name"},"agent_reference":{"type":"string","maxLength":1200,"minLength":8,"title":"Agent Reference"},"accept":{"type":"boolean","title":"Accept"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,100}$","title":"Idempotency Key"},"source":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,60}$","title":"Source","default":"direct"},"product_id":{"type":"string","enum":["sponsor-round","integration-report"],"title":"Product Id"},"expected_total_cents":{"type":"integer","title":"Expected Total Cents"},"public_credit":{"type":"boolean","title":"Public Credit","default":false},"target_url":{"type":"string","maxLength":1500,"title":"Target Url","default":""}},"additionalProperties":false,"type":"object","required":["agent_name","agent_reference","accept","idempotency_key","product_id","expected_total_cents"],"title":"PaidCheckoutRequest"},"RefundRequest":{"properties":{"reason":{"type":"string","maxLength":200,"minLength":5,"title":"Reason"}},"additionalProperties":false,"type":"object","required":["reason"],"title":"RefundRequest"},"SettingsRequest":{"properties":{"discovery_interval_minutes":{"anyOf":[{"type":"integer","maximum":10080.0,"minimum":15.0},{"type":"null"}],"title":"Discovery Interval Minutes"},"contacts_per_day":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":0.0},{"type":"null"}],"title":"Contacts Per Day"},"contacts_per_cycle":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Contacts Per Cycle"},"storage_cap_mb":{"anyOf":[{"type":"integer","maximum":500.0,"minimum":5.0},{"type":"null"}],"title":"Storage Cap Mb"},"retention_days":{"anyOf":[{"type":"integer","maximum":365.0,"minimum":1.0},{"type":"null"}],"title":"Retention Days"},"delivery_retention_days":{"anyOf":[{"type":"integer","maximum":3650.0,"minimum":1.0},{"type":"null"}],"title":"Delivery Retention Days"},"max_agents":{"anyOf":[{"type":"integer","maximum":50000.0,"minimum":10.0},{"type":"null"}],"title":"Max Agents"},"cooldown_days":{"anyOf":[{"type":"integer","maximum":365.0,"minimum":1.0},{"type":"null"}],"title":"Cooldown Days"},"serving_cooldown_seconds":{"anyOf":[{"type":"integer","maximum":3600.0,"minimum":0.0},{"type":"null"}],"title":"Serving Cooldown Seconds"},"tagline":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Tagline"},"sources":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":8},{"type":"null"}],"title":"Sources"},"seed_cards":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":50},{"type":"null"}],"title":"Seed Cards"}},"additionalProperties":false,"type":"object","title":"SettingsRequest"},"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"},"VerifyRequest":{"properties":{"challenge_id":{"type":"string","maxLength":100,"minLength":16,"title":"Challenge Id"},"card_url":{"type":"string","maxLength":1500,"title":"Card Url"}},"type":"object","required":["challenge_id","card_url"],"title":"VerifyRequest"}}}}