---
title: "List mandates for downloading files"
method: GET
path: "/v1/e-invoice/mandates"
tags: ["E-Invoicing"]
---

# List mandates for downloading files

`GET /v1/e-invoice/mandates`

Fetches mandates for downloading files based on the country code, category, and process type selection. 
This API operation returns the the list of file formats in which the document can be downloaded.

**Note**: This operation is available only if you have the <a href="https://docs.zuora.com/en/zuora-billing/bill-your-customer/leverage-advanced-capabilities/e-invoicing/e-invoicing-overview"
target="_blank">E-Invoicing</a> feature for Avalara in **Early Availabiltiy** phase enabled.

## Query parameters

- `countryCode` string
- `processType` 'Clearance' | 'ClearanceWithCancellation' | 'PEPPOLNetwork' | 'Unknown'
- `provider` string

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- EinvoiceFetchMandates
  - `data` GETEinvoiceFetchMandates[] — Container for fetching mandates.
    - `countryCode` string — 2-digit country code.
    - `fileFormats` string[] — Following mapping will be used for user representation of file formats: - XML: `application/xml` - PDF: `application/pdf` - ZIP: `application/zip` - OASIS_Universal_Business_Language_XML: `application/vnd.oasis.ubl+xml`
    - `category` 'B2B' | 'B2C' | 'B2G' — The business categories that Zuora supports for customer accounts. Supported values are B2B, B2C, or B2G.
    - `processType` 'Clearance' | 'ClearanceWithCancellation' | 'PEPPOLNetwork' | 'Unknown' — The process type of the e-invoicing business region. - If the service provider is Sovos, the process type is `Clearance` or `ClearanceWithCancellation`. - If the service provider is Avalara, the process type is `Clearance` or `PEPPOLNetwork`. - If the service provider is PEPPOL, the process type is `Unknown`.
    - `defaultFileFormats` string — The default file format.
  - `error` GETEinvoiceFetchMandatesErrors[] — Container for fetching validation errors.
    - `success` boolean — Returns `false` if the request was not processed successfully.
    - `processId` string — Process Id of the validation error.
    - `reasons` GETEinvoiceFetchMandatesErrorsReasons[] — Container for error reasons.
      - `code` string — Code for the validation error.
      - `message` string — Validation error message.
    - `requestId` string — Request Id for the validation error.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)