# DYLI developer APIs

> DYLI provides read-only marketplace data, partner Commerce checkout and fulfillment, and company-scoped 3PL shipping/vault APIs.

Use these standalone Markdown references when you need the full contract in one file:

- [Read API complete reference](https://www.dyli.io/docs/llms/read-api.md): Authentication, conventions, endpoint map, filters, pagination, response semantics, and retries for `/api/public/v1`.
- [Commerce API complete reference](https://www.dyli.io/docs/llms/commerce-api.md): Requirements, all routes, customer identity, quotes, Stripe, treasury/customer USDC, orders, Boxes, redemptions, webhooks, and testing for `/api/commerce/v1`.
- [3PL API complete reference](https://www.dyli.io/docs/llms/3pl-api.md): Address and username validation, rates, USDC payment, shipments, status, vaulting, testing, and retries for `/api/3pl/{company}`.
- [Commerce OpenAPI 3.1](https://www.dyli.io/docs/openapi/commerce-v1.openapi.json): Machine-readable Commerce paths and schemas.

## Human-readable documentation

- [Documentation home](https://www.dyli.io/docs/)
- [Quickstart](https://www.dyli.io/docs/getting-started/quickstart)
- [Authentication](https://www.dyli.io/docs/api/authentication)
- [Read API](https://www.dyli.io/docs/api/read-apis)
- [Commerce API](https://www.dyli.io/docs/api/commerce)
- [Commerce quickstart](https://www.dyli.io/docs/api/commerce-partner-setup)
- [Commerce API reference](https://www.dyli.io/docs/api/commerce-reference)
- [3PL API](https://www.dyli.io/docs/3pl)

## Base URLs

- Read: `https://www.dyli.io/api/public/v1`
- Commerce: `https://www.dyli.io/api/commerce/v1`
- 3PL: `https://www.dyli.io/api/3pl/{company}`

API keys must be kept in trusted server-side code. Prefer the `x-api-key` header; standard keys also support `Authorization: Bearer <key>`.