{"openapi":"3.1.0","info":{"title":"Persnickety Try-On Index API","version":"1.1.0","description":"Source-checked local plus-size bridal samples and at-home try-on fallbacks. Confirm current availability and terms before traveling or paying."},"servers":[{"url":"https://persnickety.bot"}],"paths":{"/api/v1/shops":{"get":{"operationId":"findBridalSamples","summary":"Find boutiques with samples available in a requested bridal size","parameters":[{"name":"state","in":"query","schema":{"type":"string","pattern":"^[A-Z]{2}$"},"description":"Two-letter US state code"},{"name":"size","in":"query","schema":{"type":"integer","minimum":0},"description":"US bridal sample size"},{"name":"q","in":"query","schema":{"type":"string"},"description":"Boutique, city, or state search"}],"responses":{"200":{"description":"Matching provider-published inventory","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"type":"object"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Shop"}}}}}}}}}},"/api/v1/shops.csv":{"get":{"operationId":"downloadBridalSamplesCsv","summary":"Download the complete source-checked boutique-location dataset as CSV","responses":{"200":{"description":"Complete bulk snapshot with source URLs and review dates","content":{"text/csv":{"schema":{"type":"string"}}}}}}},"/api/v1/try-at-home":{"get":{"operationId":"findAtHomeBridalTryOn","summary":"List source-checked wedding-dress try-on programs for shoppers without a suitable local rack","responses":{"200":{"description":"Provider-published at-home program terms with sources, cautions, and affiliate disclosure","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"type":"object"},"data":{"type":"array","items":{"$ref":"#/components/schemas/AtHomeProgram"}}}}}}}}}}},"components":{"schemas":{"Shop":{"type":"object","required":["id","name","location","sampleSizeRange","source","links"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"location":{"type":"object","properties":{"city":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"}}},"sampleSizeRange":{"type":"object","properties":{"min":{"type":"integer"},"max":{"type":"integer"},"system":{"type":"string"}}},"inventory":{"type":["object","null"]},"priceRangeUsd":{"type":["object","null"]},"specialties":{"type":"array","items":{"type":"string"}},"source":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"checkedAt":{"type":"string","format":"date"},"note":{"type":"string"}}},"links":{"type":"object","properties":{"website":{"type":"string","format":"uri"},"appointment":{"type":"string","format":"uri"},"profile":{"type":"string","format":"uri"}}}}},"AtHomeProgram":{"type":"object","required":["id","name","publishedSizing","tryOnCost","tryOnWindow","caution","reviewedAt","affiliate","returnClock","links"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"publishedSizing":{"type":"string"},"tryOnCost":{"type":"string"},"quantity":{"type":"string"},"tryOnWindow":{"type":"string"},"shippingAndReturns":{"type":"string"},"bestFor":{"type":"string"},"caution":{"type":"string"},"reviewedAt":{"type":"string","format":"date"},"affiliate":{"type":"boolean"},"returnClock":{"type":"object","required":["anchorLabel","daysAfterAnchor","resultLabel","rule"],"properties":{"anchorLabel":{"type":"string"},"daysAfterAnchor":{"type":"integer","minimum":0},"resultLabel":{"type":"string"},"rule":{"type":"string"}}},"links":{"type":"object"}}}}}}