# /entitlements/grants/export - Export the grants report to CSV or PDF

**GET /entitlements/grants/export**

Export the grants report with the same filters as GET /entitlements/grants.
With `over_limit=true` it is the list of add-ons past their tier
(Owner organization only), widest overrun first.

**Features:**
- Maximum 10,000 grants per export (DoS protection)
- CSV: system id and key, system, product, organization, reseller, add-on, tier, usage, limit, overrun, measured at, order, status, valid until
- PDF: formatted report with metadata and filters applied
- File naming: `addons_export_YYYY-MM-DD_HHmmss.[csv|pdf]`, `addons_over_tier_export_...` for the over-limit list



## Servers
- Backend API server: https://my.nethesis.it/backend/api (Backend API server)


## Authentication methods
- Bearer auth


## Parameters


### Query parameters

- **format** (string)
  Export format

- **over_limit** (string)
  When "true", only active grants past their tier limit. Owner organization only (ignored otherwise)

- **search** (string)
  Matches system name, organization name, add-on id or name and tier label

- **entitlement** (string)
  Filter by catalog id

- **organization_id** (string)
  Filter by the organization owning the system

- **source** (string)
  Filter by grant source

- **active** (string)
  When "true", only active grants



## Responses
### 200
Export file generated successfully
#### Headers

- **Content-Disposition** (string)
  Attachment filename


#### Body: text/csv (string(binary))
string(binary)
### 400
Bad request (invalid format or too many grants)

### 401
Unauthorized - invalid or missing token

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)


### 403
Forbidden - insufficient permissions

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)


### 429
Another export is already running on this instance; retry after the number of seconds in Retry-After


[Powered by Bump.sh](https://bump.sh)