# ZIP for the accountant (XML, prima nota, VAT registers) (https://docs.getbeel.com/en/api/reference/taxes/getAccountantExport)

## GET /companies/me/accountant-export

```json

{
  "operationId": "getAccountantExport",
  "summary": "ZIP for the accountant (XML, prima nota, VAT registers)",
  "description": "Everything an accountant imports for a year, quarter or month: the FatturaPA XML files of issued invoices (as sent to SDI), of received invoices (as received, or the attached file) and of the autofatture getbeel sent; prima-nota-iva.csv (one line per document and VAT rate or natura, with the XML file name); the VAT registers of each settlement period (CSV); bank movements (CSV); and LEGGIMI.txt listing any file that could not be read. Accounting packages (TeamSystem, Zucchetti, Profis and others) import the XML files with their e-invoice import; no vendor-specific layout is produced. CSV: semicolon, decimal comma, UTF-8. Italian companies only. Needs the invoices:read, received_invoices:read and bank:read scopes too. 422 too_many_documents when the period is too large for one file: ask for a quarter or a month.",
  "tags": [
    "Taxes"
  ],
  "x-required-scope": "taxes:read",
  "parameters": [
    {
      "name": "period",
      "in": "query",
      "required": true,
      "description": "A year (2026), quarter (2026-Q3) or month (2026-10)",
      "schema": {
        "type": "string",
        "pattern": "^\\d{4}(-(Q[1-4]|0[1-9]|1[0-2]))?$",
        "examples": [
          "2026",
          "2026-Q3",
          "2026-10"
        ]
      }
    }
  ],
  "responses": {
    "200": {
      "description": "ZIP archive",
      "content": {
        "application/zip": {
          "schema": {
            "type": "string",
            "contentMediaType": "application/zip"
          }
        }
      }
    },
    "400": {
      "description": "Invalid period, or not an Italian company",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "401": {
      "description": "Missing, invalid, revoked or expired API key",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "403": {
      "description": "The key lacks the 'taxes:read', 'invoices:read', 'received_invoices:read' or 'bank:read' scope",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "422": {
      "description": "too_many_documents: choose a shorter period",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "429": {
      "description": "Rate limit exceeded; see Retry-After",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "500": {
      "description": "Server error; quote X-Request-Id",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    }
  }
}

```

Full OpenAPI document: https://docs.getbeel.com/openapi.json