> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List account users

> List all users who have access to an account, including parent-organization members

`customer_get_users` (MCP tool)

Returns every user with active access to an account. If the authenticated user is an admin on a parent organization, the response covers the parent and all child accounts — each user appears once, with a `customerMemberships` array listing every account they can access. Users whose access comes from parent-organization admin propagation appear alongside directly-invited members.

## Parameters

| Field        | Type    | Required | Notes                                                                                                    |
| ------------ | ------- | -------- | -------------------------------------------------------------------------------------------------------- |
| `customerId` | integer | No       | Account to query. Defaults to your current account context. Parent admins can pass any child account ID. |

## Response

```json theme={null}
{
  "users": [
    {
      "id": "42",
      "email": "alice@example.com",
      "firstName": "Alice",
      "lastName": "Smith",
      "customerMemberships": [
        {
          "customerId": 100,
          "customerName": "Acme Inc",
          "role": "ADMIN"
        }
      ],
      "createdAt": "2026-01-15T10:00:00.000Z"
    }
  ],
  "count": 1,
  "customers": [
    { "id": 100, "name": "Acme Inc" }
  ]
}
```

| Field                                        | Type    | Notes                                                           |
| -------------------------------------------- | ------- | --------------------------------------------------------------- |
| `users`                                      | array   | Users with active access                                        |
| `users[].id`                                 | string  | User ID                                                         |
| `users[].email`                              | string  | Email address                                                   |
| `users[].firstName`                          | string  | First name                                                      |
| `users[].lastName`                           | string  | Last name                                                       |
| `users[].customerMemberships`                | array   | Accounts this user can access                                   |
| `users[].customerMemberships[].customerId`   | integer | Account ID                                                      |
| `users[].customerMemberships[].customerName` | string  | Account display name                                            |
| `users[].customerMemberships[].role`         | string  | Permission level: `BASIC`, `PREMIUM`, `ADMIN`, or `SUPER_ADMIN` |
| `users[].createdAt`                          | string  | ISO 8601 timestamp                                              |
| `count`                                      | integer | Total number of unique users                                    |
| `customers`                                  | array   | Accounts covered by this response, for filter dropdowns         |

## Errors

* `401 UNAUTHORIZED` — missing or invalid bearer token.
* `403 FORBIDDEN` — caller does not have access to the requested account.
* `404 NOT_FOUND` — account does not exist.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Account tasks" href="/v2/buyer/account/tasks" icon="list-check">
    All account operations
  </Card>

  <Card title="Get current account" href="/v2/buyer/account/tasks/get-current-account" icon="circle-user">
    Your current context
  </Card>

  <Card title="Get membership settings" href="/v2/buyer/account/tasks/get-membership" icon="users">
    Domain auto-join settings
  </Card>
</CardGroup>