List treasury accounts

Returns a paginated list of main treasury accounts onboarded for your organization.

Each item includes account identifier, display label, optional last-four digits, and currency. Balance and transaction detail are available on the account-scoped endpoints.

Query parameters

Parameter	Type	Required	Description
`cursor`	String	No	Pagination cursor from `next_cursor` in a prior response.
`limit`	Integer	No	Page size.
`order`	String	No	Sort order by account creation time: `asc` or `desc`.

Success Responses

Status Code	Description
200	OK — paginated list of treasury accounts

Error Responses

Status Code	Error Code	Description
400	VALIDATION_ERROR	Invalid query parameters
401	AUTHENTICATION_ERROR	Authentication credentials are invalid or missing
403	AUTHORIZATION_ERROR	You do not have permission to perform this action

Returns a paginated list of main treasury accounts onboarded for your organization. Each item includes account identifier, display label, optional last-four digits, and currency. Balance and transaction detail are available on the account-scoped endpoints. **Query parameters** | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cursor` | String | No | Pagination cursor from `next_cursor` in a prior response. | | `limit` | Integer | No | Page size. | | `order` | String | No | Sort order by account creation time: `asc` or `desc`. | **Success Responses** | Status Code | Description | |-------------|-------------| | 200 | OK — paginated list of treasury accounts | **Error Responses** | Status Code | Error Code | Description | |-------------|------------|-------------| | 400 | VALIDATION_ERROR | Invalid query parameters | | 401 | AUTHENTICATION_ERROR | Authentication credentials are invalid or missing | | 403 | AUTHORIZATION_ERROR | You do not have permission to perform this action |

Authentication

x-api-keystring

RootPay API key sent in the x-api-key header. Keys are environment-scoped: live_* for production, test_* for sandbox.

Query parameters

cursorstring or nullOptional

Cursor for pagination. Use the next_cursor from the previous response to get the next page.

limitintegerOptional10-500Defaults to 50

Number of items to return per page. Maximum is 500.

orderenumOptional

Sort order for results by creation time.

Allowed values:

Response

Successful Response

datalist of objects

has_moreboolean

total_countinteger or null>=0Defaults to 0

next_cursorstring or null

previous_cursorstring or null

Returns a paginated list of main treasury accounts onboarded for your organization.

Each item includes account identifier, display label, optional last-four digits, and currency. Balance and transaction detail are available on the account-scoped endpoints.

Query parameters

Parameter	Type	Required	Description
`cursor`	String	No	Pagination cursor from `next_cursor` in a prior response.
`limit`	Integer	No	Page size.
`order`	String	No	Sort order by account creation time: `asc` or `desc`.

Success Responses

Status Code	Description
200	OK — paginated list of treasury accounts

Error Responses

Status Code	Error Code	Description
400	VALIDATION_ERROR	Invalid query parameters
401	AUTHENTICATION_ERROR	Authentication credentials are invalid or missing
403	AUTHORIZATION_ERROR	You do not have permission to perform this action

1	{
2	"data": [
3	{
4	"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
5	"label": "Operating Account - Main",
6	"currency_code": "USD",
7	"created_at": "2024-01-15T09:30:00Z",
8	"updated_at": "2024-01-15T09:30:00Z",
9	"last_four_digits": "1234"
10	}
11	],
12	"has_more": true,
13	"total_count": 1,
14	"next_cursor": "3fa85f64-5717-4562-b3fc-2c963f66afb0",
15	"previous_cursor": "3fa85f64-5717-4562-b3fc-2c963f66af9f"
16	}

$	curl https://api.useroot.com/api/treasury/accounts \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json"