{"openapi":"3.1.0","info":{"title":"NC Wedding Guide Agent API","version":"1.2.0","description":"Search nearly 4,000 North Carolina wedding venues and vendors, retrieve structured listing details, prepare direct contact, or deliver a consented lead with NC Wedding Guide attribution."},"servers":[{"url":"https://www.ncweddingguide.com"}],"paths":{"/api/v1/directory":{"get":{"operationId":"searchNcWeddingDirectory","summary":"Search North Carolina wedding venues and vendors","parameters":[{"name":"category","in":"query","schema":{"type":"string","enum":["venues","photographers","videographers","planners","florists","caterers","cakes","djs","bands","bridal","jewelers","photo-booths","decor"]}},{"name":"city","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Paginated directory results"}}}},"/api/v1/vendors/{category}/{slug}":{"get":{"operationId":"getNcWeddingVendor","summary":"Get one venue or vendor","parameters":[{"name":"category","in":"path","required":true,"schema":{"type":"string","enum":["venues","photographers","videographers","planners","florists","caterers","cakes","djs","bands","bridal","jewelers","photo-booths","decor"]}},{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Structured listing details"},"404":{"description":"Listing not found"}}}},"/api/v1/inquiries":{"post":{"operationId":"requestNcWeddingVendorContact","summary":"Prepare direct contact or deliver a consented vendor lead","description":"Contact actions return the public email and a draft without sending. A send_lead action emails approved details to the selected business and reports delivery status.","requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","additionalProperties":false,"required":["category","slug","event_type","source"],"properties":{"category":{"type":"string","enum":["venues","photographers","videographers","planners","florists","caterers","cakes","djs","bands","bridal","jewelers","photo-booths","decor"]},"slug":{"type":"string"},"event_type":{"type":"string","enum":["contact_revealed","email_started","agent_contact_requested"]},"source":{"type":"string","enum":["web","webmcp","agent_api","mcp"]},"visitor_id":{"type":"string","maxLength":100},"context":{"type":"object","additionalProperties":false,"properties":{"event_date":{"type":"string"},"guest_count":{"type":"integer","minimum":1,"maximum":10000},"wedding_location":{"type":"string"},"message":{"type":"string","maxLength":2000},"agent_session_id":{"type":"string","maxLength":100},"agent_tool":{"type":"string","maxLength":30},"attribution":{"type":"string","enum":["direct","assisted"]}}}}},{"type":"object","additionalProperties":false,"required":["action","category","slug","source","inquiry"],"properties":{"action":{"type":"string","const":"send_lead"},"category":{"type":"string","enum":["venues","photographers","videographers","planners","florists","caterers","cakes","djs","bands","bridal","jewelers","photo-booths","decor"]},"slug":{"type":"string"},"source":{"type":"string","enum":["web","webmcp","agent_api","mcp"]},"visitor_id":{"type":"string","maxLength":100},"inquiry":{"type":"object","additionalProperties":false,"required":["couple_name","couple_email","consent_to_share"],"properties":{"couple_name":{"type":"string","minLength":2,"maxLength":120},"couple_email":{"type":"string","format":"email","maxLength":320},"event_date":{"type":"string","maxLength":80},"guest_count":{"type":"integer","minimum":1,"maximum":10000},"wedding_location":{"type":"string","maxLength":160},"message":{"type":"string","maxLength":2000},"consent_to_share":{"type":"boolean","const":true},"agent_session_id":{"type":"string","maxLength":100},"agent_tool":{"type":"string","maxLength":30},"attribution":{"type":"string","enum":["direct","assisted"]}}}}}]}}}},"responses":{"200":{"description":"Direct contact instructions or confirmed lead delivery"},"400":{"description":"Invalid request or missing consent"},"404":{"description":"Listing or contact email not found"},"502":{"description":"Lead email could not be delivered"}}}}}}