> ## Documentation Index
> Fetch the complete documentation index at: https://developers.ebioro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Complete reference for all Ebioro Merchant API endpoints

## Base URL

| Environment | URL                                |
| ----------- | ---------------------------------- |
| Sandbox     | `https://test-merchant.ebioro.com` |
| Production  | `https://merchant-api.ebioro.com`  |

## Authentication

All endpoints use [Digest Authentication](/authentication) with `X-Digest-Key`, `X-Digest-Timestamp`, and `X-Digest-Signature` headers.

## Response Format

All successful responses return JSON. Error responses follow this format:

```json theme={null}
{
  "reason": "Error description",
  "statusCode": 400
}
```

## Common Status Codes

| Code | Description                                      |
| ---- | ------------------------------------------------ |
| 200  | Success                                          |
| 400  | Bad request (invalid parameters)                 |
| 401  | Unauthorized (invalid or missing authentication) |
| 404  | Resource not found                               |
| 500  | Internal server error                            |

## Pagination

List endpoints support pagination with query parameters:

| Parameter | Default | Description              |
| --------- | ------- | ------------------------ |
| `page`    | 1       | Page number              |
| `limit`   | 20      | Items per page (max 100) |

Paginated responses include a `meta` object with `totalItems`, `itemCount`, `itemsPerPage`, `totalPages`, and `currentPage`.