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

# Get Invoice PDF Export Form Schema

> Backend-driven options, defaults and cap for the invoice PDF export dialog

Backend-driven descriptor for the [Export Invoice PDFs](/api-reference/billing/export-invoice-pdfs)
dialog: the type options, the default date range and the invoice cap all come
from here — the frontend never hardcodes them.

## Response

<ResponseField name="invoiceTypeOptions" type="array">
  Always the three options, in order: `all`, `electronic`, `manual`. Each is
  `{ value, label }` with a pre-localized `label`.
</ResponseField>

<ResponseField name="defaultInvoiceType" type="string">`all`</ResponseField>
<ResponseField name="defaultFrom" type="string">`YYYY-MM-DD` — first day of the current month</ResponseField>
<ResponseField name="defaultTo" type="string">`YYYY-MM-DD` — today</ResponseField>
<ResponseField name="maxInvoices" type="integer">Maximum invoices allowed in one export (currently `100`)</ResponseField>
<ResponseField name="helpText" type="string">Pre-localized help text describing what the export includes</ResponseField>

## Errors

| Status | When                        |
| :----: | --------------------------- |
|  `401` | Missing or invalid token    |
|  `403` | Caller lacks `BILLING:read` |

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.nevatal.com/api/v1/billing/invoices/pdf-export/form-schema" \
    -H "Authorization: Bearer nvtl_your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "invoiceTypeOptions": [
        { "value": "all", "label": "All" },
        { "value": "electronic", "label": "Electronic" },
        { "value": "manual", "label": "Manual" }
      ],
      "defaultInvoiceType": "all",
      "defaultFrom": "2026-09-01",
      "defaultTo": "2026-09-15",
      "maxInvoices": 100,
      "helpText": "Downloads a ZIP with the PDF of every invoice issued in the range (payer accounts and voided invoices included) plus a CSV manifest. At most 100 invoices per download."
    }
  }
  ```
</ResponseExample>