{"openapi":"3.1.0","info":{"title":"Persnickety Try-On Index API","version":"1.0.1","description":"Source-checked, provider-published plus-size bridal sample inventory. Confirm availability before traveling."},"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"}}}}}}}}}}},"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"}}}}}}}}