---
title: "List"
method: GET
path: "/orgs/accounts/list/v1"
tags: ["/orgs", "/orgs/accounts"]
---

# List

`GET /orgs/accounts/list/v1`

Lists coordinator-created shipper accounts with association filters, name search, sorting, and pagination. | authz: allowed_org_types=[provider], min_org_role=operator | () -> (AccountListRes)

## Query parameters

- `filter_account_ids` string[], nullable — Filter by selected account ids
- `search` string, nullable — Full-text account name search query
- `filter_org_id` string, nullable — Must be a string starting with `org_`
- `filter_off_chrt_org_data_id` string, nullable — Filter by associated off-CHRT shipper organization data
- `sort_by` 'name'
- `sort_order` 'asc' | 'desc' — Sort order for query results
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- AccountListRes
  - `items` Account1[], required — unresolved $ref
  - `total_count` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-24** `b5a0a0e20ff8` — 1 warning, 1 info
  - deleted the `query` request parameter `filter_account_id`
  - added the new optional `query` request parameter `filter_account_ids`

[Change history](https://skmtc.dev/chrt/apis/chrt-fastapi/changes/orgs/accounts/list/v1/get.md)

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/chrt/apis/chrt-fastapi/revisions/1a1e5a995fc9?raw)
