Skip to main content

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​

AreaEndpoints
ProductsAll available products, ready-to-ship (rush), and made-to-order (standard), filterable by color, size, fabric and type
ColorsThe color taxonomy, shopper-facing color families, and the colors a product or swatch bundle comes in
SizesSizes in use, the expected size range for a style, and which sizes a product can be bought in
Fabrics and typesThe values the other filters accept
Back-in-stock datesEach product's expected restock date and whether the site's date needs updating

How it's reached​

EnvironmentBase URL
Productionhttps://api.birdygrey.com/catalog
Staginghttps://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​