API Endpoints

A reference for the most common REST endpoints and how to call them.

The REST API is organized around resources. Below is an example of fetching a list of items.

GET /items

Returns a paginated list of items. Supports limit and skip query parameters for pagination.

Responses are returned as JSON with a consistent envelope structure.

cURL

```bash
curl https://api.acme.com/v1/items?limit=10 \
  -H "Authorization: Bearer $ACME_API_KEY"
```