---
title: "Retrieve e-invoicing settings"
description: "The e-invoicing setup: whether it is available for the store (German stores), switched on and actually active (paid plan and a complete seller profile), whether e-invoices are generated automatically or on request, and t"
url: https://docs.invoicefalcon.com/v3-reference/account/retrieve-e-invoicing-settings/
api: "API v3 reference"
method: GET
path: "/account/e_invoicing"
---

# Retrieve e-invoicing settings

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

The e-invoicing setup: whether it is available for the store (German stores), switched on and actually active (paid plan and a complete seller profile), whether e-invoices are generated automatically or on request, and the seller profile (legal name, VAT id or tax number, city, postcode, small-business status, bank details) with the values resolved from store details where the profile leaves them blank. Read-only.

`generation` values: `automatic` (Generate with every invoice), `manual` (Generate on request).

## Returns

- `enabled` (boolean): e.g. `false`
- `generation` (string): e.g. `automatic`
- `seller` (object)
  - `legal_name` (string, nullable)
  - `vat_id` (string, nullable)
  - `tax_number` (string, nullable)
  - `city` (string, nullable)
  - `zip` (string, nullable)
  - `small_business` (boolean): e.g. `false`
  - `country_code` (string): e.g. `DE`
  - `resolved` (object)
    - `legal_name` (string): e.g. `Acme GmbH`
    - `city` (string): e.g. `Barwaha, khargone`
    - `zip` (string): e.g. `451115`
- `bank` (object)
  - `iban` (string, nullable)
  - `bic` (string, nullable)
  - `name` (string, nullable)
- `available` (boolean): e.g. `false`
- `active` (boolean): e.g. `false`
- `manual_mode` (boolean): e.g. `false`
- `ready` (boolean): e.g. `false`
- `configured` (boolean): e.g. `false`

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/e_invoicing" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
```

## 200

The requested resource.

```json
{
  "enabled": false,
  "generation": "automatic",
  "seller": {
    "legal_name": null,
    "vat_id": null,
    "tax_number": null,
    "city": null,
    "zip": null,
    "small_business": false,
    "country_code": "DE",
    "resolved": {
      "legal_name": "Acme GmbH",
      "city": "Barwaha, khargone",
      "zip": "451115"
    }
  },
  "bank": {
    "iban": null,
    "bic": null,
    "name": null
  },
  "available": false,
  "active": false,
  "manual_mode": false,
  "ready": false,
  "configured": false
}
```

## 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"
}
```

