For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/account/list-organization-users.md.

List the users your organization trades for

Organization tokenNo token

GET
/organizations/{organization_id}/users

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.

Authorization

bearerAuth
headerAuthorizationBearer <JWT>

An access token from POST /v1/auth/api-key/token. An organization token lasts one hour and has no refresh token; a personal token can be refreshed.

Path Parameters

organization_id*string

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.

Formatuuid

Query Parameters

external_ref_id?string

Narrow the page to the user created under this reference.

Match^[A-Za-z0-9_-]{1,64}$
cursor?string

Opaque cursor from a prior page.

limit?integer

Maximum users to return; above 100 is clamped to 100 and echoed back.

Range1 <= value
Default50

Response Body

A page of users

application/json
  1. response
data*array<>
pagination*

Pagination metadata

Example Request
curl -X GET 'https://api.truemarkets.co/v1/account/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/users'
Example Response
{  "data": [    {      "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",      "external_ref_id": "string",      "created_at": "2019-08-24T14:15:22Z",      "wallets": [        {          "address": "string",          "chain_family": "evm"        }      ]    }  ],  "pagination": {    "next_cursor": "string",    "limit": 0  }}