> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gvb-staging.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Tenants and permissions

> Select tenant context and request the minimum access.

Call `GET /tenants` first. Use an returned `tenant_id` in `/tenants/{tenant}/...`; inaccessible tenants deliberately behave like unavailable resources.

| Capability         | Required permission               |
| ------------------ | --------------------------------- |
| Tenant directory   | Token access only                 |
| Catalog vouchers   | `view_vouchers`                   |
| Catalog categories | `view_categories`                 |
| Purchased vouchers | `view_vouchers` and `view_orders` |
| Marketing signups  | `export_customer_information`     |
| Resolve and redeem | `redeem_vouchers`                 |

Permission failures return `403`; unknown or out-of-scope records return `404`.