---
title: "Read the settings of the account"
method: GET
path: "/account"
tags: ["Account"]
---

# Read the settings of the account

`GET /account`

## Request

- Base URL: `https://api.epovest.com/v1`
- URL: `https://api.epovest.com/v1/account`
- Auth: HTTP bearer

The legal name, the billing country, the postal address and the intra-EU VAT number, plus the
language we write to the account in and the time zone its hours are shown in. Read before you
write: only the fields you send change, so this answer is what tells you the value of
everything you are leaving alone. `language` and `timezone` always come back with the value
in force, `en` and `UTC` by default.

## Response `200`

The settings of the account.

- object
  - `account` Account, required
    - `name` string, nullable, required: The legal name of the account, the one printed on its invoices.
    - `billing_country` string, nullable, required: An ISO 3166-1 alpha-2 code. It decides the tax treatment of the next invoices, so it is the country of the entity being billed.
    - `billing_address` string[], required: The postal address, one string per line.
    - `intra_eu_vat_number` string, nullable, required
    - `language` 'en' | 'fr' | 'es' | 'de' | 'it' | 'pt', required: The language we write to this account in, for emails and for the hosted payment page of a top-up.
    - `timezone` string, required: The time zone the hours of the account are shown in, as an IANA identifier.
    - `member` object, nullable, required: Who the language and the time zone belong to: the person a one-click connection acts for, or the oldest active owner of the account.
      - `email` string
      - `name` string, nullable
      - `role` 'owner' | 'manager' | 'operator'
    - `created_at` string, date-time, required

## Other responses

- `401`: `unauthenticated`: missing, unknown or revoked key.
- `403`: `insufficient_scope`: the credential may not do this, either because the key lacks the scope, or, on a one-click connection, because the person lacks the role the action needs (manager, or owner to start, pause and top up). On that path, read it as "this person may not do this" and tell them which role the action needs.
- `429`: `rate_limited`: 120 requests per minute per credential, sliding window. Retry after `Retry-After` seconds.

---

[API](https://skmtc.dev/epovest/apis/epovest-api.md) · [All operations](https://skmtc.dev/epovest/apis/epovest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/epovest/apis/epovest-api/revisions/7a78ee27ecbb?raw)