Catalog API
A read-only API over Birdy Grey's live catalog. Partners and internal apps use it to find products, colors, sizes and availability without touching Shopify or Airtable directly.
What it servesβ
| Area | Endpoints |
|---|---|
| Products | All available products, ready-to-ship (rush), and made-to-order (standard), filterable by color, size, fabric and type |
| Colors | The color taxonomy, shopper-facing color families, and the colors a product or swatch bundle comes in |
| Sizes | Sizes in use, the expected size range for a style, and which sizes a product can be bought in |
| Fabrics and types | The values the other filters accept |
| Back-in-stock dates | Each product's expected restock date and whether the site's date needs updating |
How it's reachedβ
| Environment | Base URL |
|---|---|
| Production | https://api.birdygrey.com/catalog |
| Staging | https://api.birdystaging.com/catalog |
Every request goes through the Birdy Grey API Gateway and needs an API key in the x-api-key header. The service can't be called directly.
API referenceβ
- Interactive docs: api.birdygrey.com/catalog/public/docs
- OpenAPI spec: api.birdygrey.com/catalog/public/openapi