{"openapi":"3.1.0","info":{"title":"Orange Pill Coffee agent API","version":"opc/0.1","description":"Agents create quotes; a human pays the Stripe Checkout link. USA shipping only. No substitutions, no refunds. All writes need Idempotency-Key."},"servers":[{"url":"https://api.orangepillcoffee.com"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}}},"paths":{"/agent-info":{"get":{"summary":"Merchant info and policy"}},"/v1/catalog":{"get":{"summary":"Products and prices (minor units, usd)"}},"/v1/quote-requests":{"post":{"security":[{"bearer":[]}],"summary":"Create an immutable quote. Quote may instead return status WAITLIST_OFFERED when stock is short on a waitlist bean. Body: {buyer:{email}, shipments:[{recipient_ref,address:{name,line1,line2?,city,region,postal_code,country:'US'},items:[{product_id,quantity}],gift_notes?:[string<=200, max one per bag]}], preferences?:{substitutions:'none'}}"}},"/v1/agents/register":{"post":{"summary":"Public. Register an agent and receive an API key instantly (shown once). Body {name, contact_email}. Rate limited."}},"/v1/waitlist":{"post":{"security":[{"bearer":[]}],"summary":"Join a bean waitlist. Body {product_id, quantity, buyer:{email}}. Returns position; ETA unknown."}},"/v1/waitlist/{id}":{"get":{"security":[{"bearer":[]}],"summary":"Waitlist entry status"},"delete":{"security":[{"bearer":[]}],"summary":"Leave the waitlist"}},"/v1/quotes/{id}":{"get":{"security":[{"bearer":[]}],"summary":"Read a quote"}},"/v1/quotes/{id}/checkout":{"post":{"security":[{"bearer":[]}],"summary":"Body {quote_hash}. Returns review_url for the human buyer to pay."}},"/v1/quotes/{id}/order":{"get":{"security":[{"bearer":[]}],"summary":"Order for a quote, once payment is verified"}},"/v1/orders/{id}":{"get":{"security":[{"bearer":[]}],"summary":"Order status"}},"/v1/orders/{id}/events":{"get":{"security":[{"bearer":[]}],"summary":"Events after ?after=<sequence>"}},"/v1/orders/{id}/cancel-requests":{"post":{"security":[{"bearer":[]}],"summary":"Request cancellation (seller decides; no refunds policy)"}}}}