{"openapi":"3.1.0","info":{"title":"ZipScout Public Read API","version":"1.0.0","description":"Read-only public data. No account data, reservations, signatures or payments."},"servers":[{"url":"/api/v1/public"}],"paths":{"/catalog":{"get":{"operationId":"publicCatalog","responses":{"200":{"description":"Public information","content":{"application/json":{"schema":{"type":"object","required":["currency","billingUnit","homesAreTarget","included","exclusivity","tiers"],"properties":{"currency":{"const":"USD"},"billingUnit":{"const":"issue_month"},"homesAreTarget":{"const":true},"included":{"type":"string"},"exclusivity":{"type":"string"},"tiers":{"type":"array","items":{"type":"object","required":["id","name","size","priceCents","categoryExclusive","description"],"additionalProperties":false,"properties":{"id":{"type":"string","enum":["spotlight","quarter","half","full","cover"]},"name":{"type":"string"},"size":{"type":"string"},"priceCents":{"type":"integer"},"categoryExclusive":{"type":"boolean"},"description":{"type":"string"}}}}}}}}},"400":{"description":"Invalid ZIP or category"},"429":{"description":"Rate limit reached","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until retry"}}}}}},"/specs":{"get":{"operationId":"publicSpecs","responses":{"200":{"description":"Public information","content":{"application/json":{"schema":{"type":"object","required":["currency","billingUnit","homesAreTarget","included","exclusivity","tiers"],"properties":{"currency":{"const":"USD"},"billingUnit":{"const":"issue_month"},"homesAreTarget":{"const":true},"included":{"type":"string"},"exclusivity":{"type":"string"},"tiers":{"type":"array","items":{"type":"object","required":["id","name","size","priceCents","categoryExclusive","description"],"additionalProperties":false,"properties":{"id":{"type":"string","enum":["spotlight","quarter","half","full","cover"]},"name":{"type":"string"},"size":{"type":"string"},"priceCents":{"type":"integer"},"categoryExclusive":{"type":"boolean"},"description":{"type":"string"}}}}}}}}},"400":{"description":"Invalid ZIP or category"},"429":{"description":"Rate limit reached","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until retry"}}}}}},"/issues":{"get":{"operationId":"publicIssues","parameters":[{"name":"zip","in":"query","required":true,"schema":{"type":"string","pattern":"^[0-9]{5}$"}}],"responses":{"200":{"description":"Public information","content":{"application/json":{"schema":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","required":["id","title","zips","targetHomes","artworkDeadline","plannedMailDate","actualMailDate","timeZone","status"],"properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"zips":{"type":"array","items":{"type":"string"}},"targetHomes":{"type":"integer"},"artworkDeadline":{"type":"string","format":"date-time"},"plannedMailDate":{"type":"string","format":"date-time"},"actualMailDate":{"type":["string","null"],"format":"date"},"timeZone":{"const":"America/New_York"},"status":{"const":"open"}}}}},"required":["issues"]}}}},"400":{"description":"Invalid ZIP or category"},"429":{"description":"Rate limit reached","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until retry"}}}}}},"/availability":{"get":{"operationId":"publicAvailability","parameters":[{"name":"zip","in":"query","required":true,"schema":{"type":"string","pattern":"^[0-9]{5}$"}},{"name":"category","in":"query","required":true,"schema":{"type":"string","maxLength":100}}],"responses":{"200":{"description":"Public information","content":{"application/json":{"schema":{"type":"object","required":["currency","reservation","issues"],"properties":{"currency":{"const":"USD"},"reservation":{"const":false},"issues":{"type":"array","items":{"type":"object","required":["id","title","zips","targetHomes","artworkDeadline","plannedMailDate","timeZone","offers"],"properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"zips":{"type":"array","items":{"type":"string"}},"targetHomes":{"type":"integer"},"artworkDeadline":{"type":"string","format":"date-time"},"plannedMailDate":{"type":"string","format":"date-time"},"timeZone":{"const":"America/New_York"},"offers":{"type":"array","items":{"type":"object","required":["sizeId","priceCents","remaining","availability"],"properties":{"sizeId":{"type":"string"},"priceCents":{"type":"integer"},"remaining":{"type":"integer","minimum":0},"availability":{"enum":["in_stock","sold_out","category_taken"]}}}}}}}}}}}},"400":{"description":"Invalid ZIP or category"},"429":{"description":"Rate limit reached","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until retry"}}}}}},"/policies":{"get":{"operationId":"publicPolicies","responses":{"200":{"description":"Public information","content":{"application/json":{"schema":{"type":"object","required":["termsUrl","privacyUrl","refundPolicyUrl","purchase","approvals","delivery","availability","audit"],"properties":{"termsUrl":{"type":"string"},"privacyUrl":{"type":"string"},"refundPolicyUrl":{"type":"string"},"purchase":{"type":"string"},"approvals":{"type":"string"},"delivery":{"type":"string"},"availability":{"type":"string"},"audit":{"type":"string"}}}}}},"400":{"description":"Invalid ZIP or category"},"429":{"description":"Rate limit reached","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until retry"}}}}}}}}