---
title: "Retrieve list of users on the account"
method: GET
path: "/account/users"
tags: ["account"]
---

# Retrieve list of users on the account

`GET /account/users`

## Request

- Base URL: `https://docs-api.formify.eu/v1`
- URL: `https://docs-api.formify.eu/v1/account/users`
- Auth: OAuth 2 (authorization code, authorization URL `https://docs-api.formify.eu/v1/oauth/authorize`, token URL `https://docs-api.formify.eu/v1/oauth/token`)

Retrieve a list of users on the account. Invited users with pending invitations are also included in the list (`invited`).

## Query parameters

- `errorLanguage` 'en' | 'sv' | 'es'

## Response `200`

List of account users retrieved successfully.

- object
  - `users` object[]
    - `userId` string, uuid: Unique identifier for the user.
    - `email` string, email: Email address of the user.
    - `firstName` string: User's first name.
    - `lastName` string: User's last name.
    - `fullName` string: User's full name, if available.
    - `roles` string[]: Roles assigned to the user within the account.
    - `status` 'active' | 'invited': Status of the user on the account.

## Other responses

- `401`: Unauthorized - Missing or invalid access token.
- `404`: Not Found - Account or users resource not found
- `500`: Internal server error

---

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