# Kalixo API

> Developer documentation for the Kalixo Distribution API v2 — catalog, ordering, bulk fulfilment and wallet.

## Docs

- [Get a single product](https://developer.kalixo.io/api-reference/catalog/get-a-single-product.md): Returns a single catalog product by its product id.
- [List catalog products](https://developer.kalixo.io/api-reference/catalog/list-catalog-products.md): Returns the products in your catalog. Supports filtering and pagination. Filters are AND-combined across fields; within a single field you may pass multiple comma-separated values (for example `country=GB,IE`).
- [API reference](https://developer.kalixo.io/api-reference/introduction.md): Endpoints, schemas, and a built-in playground to test live calls.
- [Place an order](https://developer.kalixo.io/api-reference/orders/place-an-order.md): Creates an order and begins fulfilment asynchronously. The response returns immediately with an `orderId` and a `processing` status. Large orders are automatically segmented; the response includes an `estimatedReadyAt` timestamp telling you roughly when to poll for codes.
- [Retrieve an order](https://developer.kalixo.io/api-reference/orders/retrieve-an-order.md): Fetches an order by its numeric `orderId` or by your `externalOrderCode`.
- [Get wallet balances](https://developer.kalixo.io/api-reference/wallet/get-wallet-balances.md): Returns your current wallet balances per currency, plus a low-balance flag and the configured threshold.
- [Authentication](https://developer.kalixo.io/authentication.md): Authenticate every request with your Kalixo API key.
- [Errors](https://developer.kalixo.io/concepts/errors.md): A consistent error model across every endpoint.
- [Filtering](https://developer.kalixo.io/concepts/filtering.md): Narrow the catalog by country, language, brand, category, and tag.
- [Idempotency](https://developer.kalixo.io/concepts/idempotency.md): Safely retry order requests without creating duplicates.
- [Notifications](https://developer.kalixo.io/concepts/notifications.md): Stay ahead of a low wallet balance with automatic email alerts.
- [Open-denomination products](https://developer.kalixo.io/concepts/open-denomination.md): Order products where you choose the amount within a range.
- [Order lifecycle](https://developer.kalixo.io/concepts/order-lifecycle.md): How async orders move from processing to completed — and how bulk orders are handled.
- [Pagination](https://developer.kalixo.io/concepts/pagination.md): Page through large result sets with skip and take.
- [Rate limits](https://developer.kalixo.io/concepts/rate-limits.md): Stay within request limits and handle 429 responses gracefully.
- [Kalixo Distribution API](https://developer.kalixo.io/index.md): Browse your catalog, order digital gift cards, and track delivery — all from one modern REST API.
- [Migrating from v1](https://developer.kalixo.io/migrating-from-v1.md): What changed in v2 and how to upgrade your integration.
- [Quickstart](https://developer.kalixo.io/quickstart.md): From zero to your first delivered order in four steps.

## OpenAPI Specs

- [openapi](https://developer.kalixo.io/openapi.json)