# Byrd Catalog API

**Canonical:** https://apis.io/apis/byrd/byrd-catalog-api/  
**Provider:** Byrd — https://apis.io/providers/byrd/  
**Base URL:** https://api.getbyrd.com  
**Documentation:** https://developers.getbyrd.com

Byrd Catalog API is one of 5 APIs that [Byrd](https://apis.io/providers/byrd/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Catalog. The published artifact set on APIs.io includes an OpenAPI specification, authentication docs, rate-limit docs, a changelog, and 6 JSON Schemas.

Products and bundles, their lots, serial numbers and stock, and the dangerous goods limits that apply to them.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/warehouse/dangerous-goods-limits` | List the supported dangerous goods |
| GET | `/v2/warehouse/lots` | List lots |
| POST | `/v2/warehouse/lots` | Create a lot |
| GET | `/v2/warehouse/lots/{lot_id}` | Get a lot |
| PATCH | `/v2/warehouse/lots/{lot_id}` | Update a lot |
| GET | `/v2/warehouse/products` | List your products |
| POST | `/v2/warehouse/products` | Create a product |
| GET | `/v2/warehouse/products/{bundle_id}/bundles` | List the ingredients of a bundle |
| POST | `/v2/warehouse/products/{bundle_id}/bundles` | Add an ingredient to a bundle |
| PUT | `/v2/warehouse/products/{bundle_id}/bundles` | Set the ingredients of a bundle |
| GET | `/v2/warehouse/products/{bundle_id}/bundles/{ingredient_id}` | Get an ingredient of a bundle |
| DELETE | `/v2/warehouse/products/{bundle_id}/bundles/{ingredient_id}` | Remove an ingredient from a bundle |
| GET | `/v2/warehouse/products/{product_id}` | Get a product |
| PUT | `/v2/warehouse/products/{product_id}` | Update a product |
| PATCH | `/v2/warehouse/products/{product_id}` | Update a product |
| DELETE | `/v2/warehouse/products/{product_id}` | Delete a product |
| GET | `/v2/warehouse/products/{product_id}/serial-numbers` | List the serial numbers of a product |
| GET | `/v2/warehouse/products/{product_id}/stats` | Get stock statistics for a product |
| GET | `/v2/warehouse/products/{product_id}/stock-by-warehouse` | Get a product's stock per warehouse |

## Machine-readable artifacts (15)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/openapi/byrd-catalog-api-openapi.yml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/authentication/byrd-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/conventions/byrd-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/errors/byrd-error-codes.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/rate-limits/byrd-rate-limits.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/lifecycle/byrd-lifecycle.yml
- **ChangeLog** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/changelog/byrd-changelog.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/conformance/byrd-conformance.yml
- **X-MCPServerCandidate** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/mcp/byrd-mcp.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/json-schema/byrd-product-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/json-schema/byrd-delivery-with-metrics-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/json-schema/byrd-delivery-create-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/json-schema/byrd-delivery-create-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/json-schema/byrd-shipment-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/byrd/refs/heads/main/json-schema/byrd-delivery-schema.json

## Other Byrd APIs (4)

- [Byrd Account API](https://apis.io/apis/byrd/byrd-account-api/)
- [Byrd Authentication API](https://apis.io/apis/byrd/byrd-authentication-api/)
- [Byrd Inbound API](https://apis.io/apis/byrd/byrd-inbound-api/)
- [Byrd Shipments API](https://apis.io/apis/byrd/byrd-shipments-api/)

## Tags

Catalog

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/byrd/byrd-catalog-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/byrd/.