{"openapi":"3.1.0","info":{"title":"Santa's Calling API","description":"For AI assistants and agents: find out about Santa's Calling (a live phone call from Santa for a child in the UK, £6.99) and buy a gift call. The buyer pays on Stripe Checkout. MCP server: /mcp. Summary: /llms.txt.","version":"1.0.0"},"paths":{"/api/v1/info":{"get":{"tags":["about"],"summary":"What Santa's Calling is, price, ages and how a gift works","operationId":"api_info_api_v1_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/faq":{"get":{"tags":["about"],"summary":"Frequently asked questions","operationId":"api_faq_api_v1_faq_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/gifts":{"post":{"tags":["gifts"],"summary":"Start a gift call: returns a Stripe Checkout link for the buyer to pay","operationId":"api_create_gift_api_v1_gifts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftIn"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gifts/{code}":{"get":{"tags":["gifts"],"summary":"Status of a gift (and its link, once paid)","operationId":"api_gift_status_api_v1_gifts__code__get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"GiftIn":{"properties":{"buyer_name":{"type":"string","maxLength":60,"title":"Buyer Name","description":"Who the gift is from, as the family will see it"},"buyer_email":{"type":"string","maxLength":254,"title":"Buyer Email","description":"Receipt and gift link go here"},"recipient_name":{"type":"string","maxLength":60,"title":"Recipient Name","description":"Optional: who it's for, e.g. 'Sarah & Tom'","default":""},"recipient_email":{"type":"string","maxLength":254,"title":"Recipient Email","description":"Optional: we email them the gift link once paid","default":""},"message":{"type":"string","maxLength":300,"title":"Message","description":"Optional message shown with the gift","default":""},"promo_code":{"type":"string","maxLength":40,"title":"Promo Code","description":"Optional promotion code","default":""}},"type":"object","required":["buyer_name","buyer_email"],"title":"GiftIn"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"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"}}}}