# List taxes

GET https://api.oletapp.com/your-store/v1/taxes

Readable by any valid credential: it is reference data needed to interpret product prices and sale totals, which are scoped to other permissions.

- `400 VALIDATION_FAILED`: `include_deleted=true` combined with `order=desc`.

**Requires scope:** `any`

Required scope: `any`

## Parameters

| Name | In | Type | Required |
|---|---|---|---|
| `limit` | query | integer | no |
| `cursor` | query | string | no |
| `order` | query | "asc" | "desc" | no |
| `include_deleted` | query | boolean | no |

## Response (200)

```
{
  data: { ... }[]
  has_more: boolean
  next_cursor: string | null
}
```

Errors follow the standard error envelope: https://getolet.com/resources/developers/errors.md

## Example

```bash
curl -X GET "https://api.oletapp.com/your-store/v1/taxes" \
  -H "Authorization: Bearer olet_live_YOUR_API_KEY"
```