---
title: "List the users your organization trades for"
url: https://docs.truemarkets.co/api/account/list-organization-users
description: "Returns your organization's users, newest first. Page with the opaque cursor from pagination.next_cursor. Supply external_ref_id instead to look up a single user by the reference you created them with; a reference matching nothing is an empty page."
---

Docs index: https://docs.truemarkets.co/llms.txt

# List the users your organization trades for

Returns your organization's users, newest first. Page with the opaque `cursor` from
`pagination.next_cursor`. Supply `external_ref_id` instead to look up a single user by the
reference you created them with; a reference matching nothing is an empty page.

## Request

```
GET https://api.truemarkets.co/v1/account/organizations/{organization_id}/users
```

### Authentication

Bearer token in `Authorization`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `organization_id` | path | string (uuid) | yes | Your organization's id: the `tm.organization_id` claim of an organization token, also shown on the dashboard Overview. The token must be this organization's, or belong to one of its admins. |
| `external_ref_id` | query | string | no | Narrow the page to the user created under this reference. |
| `cursor` | query | string | no | Opaque cursor from a prior page. |
| `limit` | query | integer | no | Maximum users to return; above 100 is clamped to 100 and echoed back. |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

A page of users

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | array of object | yes |  |
| `data[].user_id` | string (uuid) | yes |  |
| `data[].external_ref_id` | string | yes | The reference the client names a served user by, unique within the organization. Compared exactly as sent, with no case or format normalisation, so send the same string every time (a UUID in one consistent case). |
| `data[].created_at` | string (date-time) | yes |  |
| `data[].wallets` | array of object | yes | Empty only while the wallet step has not completed; re-send the create to finish it. |
| `data[].wallets[].address` | string | yes |  |
| `data[].wallets[].chain_family` | string, one of `evm`, `solana` | yes | The family of chains this address serves. An `evm` address is the same on every EVM chain (base, arbitrum, robinhood); a `solana` address serves solana. |
| `pagination` | object | yes | Pagination metadata |
| `pagination.next_cursor` | string, nullable | yes | Cursor for the next page of results, null if no more pages |
| `pagination.limit` | integer | yes | Number of results returned in this page |

### 400

Malformed organization id, external reference, cursor or limit

### 401

Unauthorized

### 403

Forbidden

### 500

Internal server error

### 503

Service unavailable
