---
title: "Retrieve email settings"
description: "The email language and, for each document type (invoice, quote, credit note, payment reminder), the subject and body the store sends, with customized telling whether that is the merchant's own text or the default for the"
url: https://docs.invoicefalcon.com/v3-reference/account/retrieve-email-settings/
api: "API v3 reference"
method: GET
path: "/account/emails"
---

# Retrieve email settings

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

The email language and, for each document type (invoice, quote, credit note, payment reminder), the subject and body the store sends, with `customized` telling whether that is the merchant's own text or the default for the language. Read-only.

## Returns

- `locale` (string): e.g. `en`
- `custom_text` (boolean): e.g. `false`
- `templates` (object)
  - `invoice` (object)
    - `subject` (string): e.g. `Your invoice {{order_number}}`
    - `body` (string): e.g. `Hi`
    - `customized` (boolean): e.g. `true`
    - `in_use` (boolean): e.g. `false`
  - `quote` (object)
    - `subject` (string): e.g. `{{shop_name}} - Quote for your Order {{order_number}}`
    - `body` (string): e.g. `Hello,

Thank you for shopping at {{shop_name}}. We have …`
    - `customized` (boolean): e.g. `false`
    - `in_use` (boolean): e.g. `false`
  - `credit_note` (object)
    - `subject` (string): e.g. `{{shop_name}} - Credit Note {{order_number}}`
    - `body` (string): e.g. `Hello,

Please find attached the credit note for your ord…`
    - `customized` (boolean): e.g. `false`
    - `in_use` (boolean): e.g. `false`
  - `payment_reminder` (object)
    - `subject` (string): e.g. `{{shop_name}} - Reminder for your Invoice {{order_number}}`
    - `body` (string): e.g. `Hello,

Thank you for shopping at {{shop_name}}. This is …`
    - `customized` (boolean): e.g. `false`
    - `in_use` (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/emails" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
```

## 200

The requested resource.

```json
{
  "locale": "en",
  "custom_text": false,
  "templates": {
    "invoice": {
      "subject": "Your invoice {{order_number}}",
      "body": "Hi",
      "customized": true,
      "in_use": false
    },
    "quote": {
      "subject": "{{shop_name}} - Quote for your Order {{order_number}}",
      "body": "Hello,\n\nThank you for shopping at {{shop_name}}. We have attached the Quote for your Order {{order_number}} to this email.\n\nRegards,\nThe {{shop_name}} Team",
      "customized": false,
      "in_use": false
    },
    "credit_note": {
      "subject": "{{shop_name}} - Credit Note {{order_number}}",
      "body": "Hello,\n\nPlease find attached the credit note for your order to this email.\n\nRegards,\nThe {{shop_name}} Team",
      "customized": false,
      "in_use": false
    },
    "payment_reminder": {
      "subject": "{{shop_name}} - Reminder for your Invoice {{order_number}}",
      "body": "Hello,\n\nThank you for shopping at {{shop_name}}. This is a gentle reminder that your invoice {{invoice_number}} is past due.\n\nIf you have already paid this invoice, please disregard this message.\n\nBest,\nThe {{shop_name}} Team",
      "customized": false,
      "in_use": 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"
}
```

