---
title: "Retrieve document settings"
description: "The document defaults: invoice numbering (prefix, next number, order number reuse), which dates are printed, document language and auto-detection, multicurrency, PDF file name, the business name, address, contact and tax"
url: https://docs.invoicefalcon.com/v3-reference/account/retrieve-document-settings/
api: "API v3 reference"
method: GET
path: "/account/documents"
---

# Retrieve document settings

`GET https://app.invoicefalcon.com/api/v3/external/account/documents`

The document defaults: invoice numbering (prefix, next number, order number reuse), which dates are printed, document language and auto-detection, multicurrency, PDF file name, the business name, address, contact and tax registration shown on every document, invoice locking, EU VAT footer notes and the &quot;Created with Invoice Falcon&quot; brand. Read-only.

## Returns

- `numbering` (object)
  - `invoice_prefix` (string): e.g. `INV`
  - `next_invoice_number` (string, nullable)
  - `use_order_number` (boolean): e.g. `false`
  - `credit_notes_use_invoice_number` (boolean): e.g. `false`
  - `per_template_numbering_available` (boolean): e.g. `true`
- `dates` (object)
  - `use_order_created_date` (boolean): e.g. `false`
  - `use_paid_date` (boolean): e.g. `false`
- `language` (object)
  - `document_locale` (string): e.g. `en`
  - `auto_detect_customer_language` (boolean): e.g. `false`
  - `translate_product_names` (boolean): e.g. `false`
  - `available_locales` (array of strings)
- `currency` (object)
  - `multicurrency` (boolean): e.g. `true`
  - `show_currency_code` (boolean): e.g. `true`
- `pdf` (object)
  - `file_name` (string, nullable)
- `business` (object)
  - `name` (string): e.g. `Acme GmbH`
  - `address_line_1` (string, nullable)
  - `address_line_2` (string, nullable)
  - `city_line` (string, nullable)
  - `country_line` (string, nullable)
  - `email` (string, nullable)
  - `phone` (string, nullable)
- `tax` (object)
  - `registration_number` (string, nullable)
  - `shown_as` (string, nullable)
- `compliance` (object)
  - `lock_invoices_after_issue` (boolean): e.g. `false`
- `eu_vat_footer_notes` (object)
  - `outside_eu` (string, nullable)
  - `inside_eu` (string, nullable)
  - `available` (boolean): e.g. `false`
- `branding` (object)
  - `show_invoice_falcon_brand` (boolean): e.g. `true`
  - `removal_available` (boolean): e.g. `true`

Rate limit: this call costs 1 point ([rate limits](https://docs.invoicefalcon.com/v3/docs/api-v3/rate-limits/)).

## Example request

```sh
curl "https://app.invoicefalcon.com/api/v3/external/account/documents" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
```

## 200

The requested resource.

```json
{
  "numbering": {
    "invoice_prefix": "INV",
    "next_invoice_number": null,
    "use_order_number": false,
    "credit_notes_use_invoice_number": false,
    "per_template_numbering_available": true
  },
  "dates": {
    "use_order_created_date": false,
    "use_paid_date": false
  },
  "language": {
    "document_locale": "en",
    "auto_detect_customer_language": false,
    "translate_product_names": false,
    "available_locales": [
      "az",
      "bg",
      "cs"
    ]
  },
  "currency": {
    "multicurrency": true,
    "show_currency_code": true
  },
  "pdf": {
    "file_name": null
  },
  "business": {
    "name": "Acme GmbH",
    "address_line_1": null,
    "address_line_2": null,
    "city_line": null,
    "country_line": null,
    "email": null,
    "phone": null
  },
  "tax": {
    "registration_number": null,
    "shown_as": null
  },
  "compliance": {
    "lock_invoices_after_issue": false
  },
  "eu_vat_footer_notes": {
    "outside_eu": null,
    "inside_eu": null,
    "available": false
  },
  "branding": {
    "show_invoice_falcon_brand": true,
    "removal_available": true
  }
}
```

## 401

Missing or unknown `X-Auth-Token`, or the shop uninstalled the app.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "unauthorized"
}
```

## 403

`v3_required`: the shop still runs the previous dashboard. `paid_plan_required`: API access needs a paid plan.

```json
{
  "errors": [
    "API access requires a paid plan"
  ],
  "code": "paid_plan_required"
}
```

## 422

The request failed validation. Nothing was saved.

```json
{
  "errors": [
    "id is missing"
  ]
}
```

## 429

Rate limited: cost-weighted per key (reads cost less than writes). Wait `Retry-After` seconds; see `X-RateLimit-*` headers.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited"
}
```

