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

# List

`GET /orgs/contacts/list/v1`

Lists organization-created contacts with associated organizations and accounts expanded. | authz: min_org_role=operator | () -> (ContactListRes)

## Query parameters

- `search` string, nullable — Full-text 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 organization data
- `filter_account_id` string, nullable — Filter by associated account
- `sort_by` 'name'
- `sort_order` 'asc' | 'desc' — Sort order for query results
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- ContactListRes
  - `items` ContactExpandedListItem[], required
    - `contact` Contact1, required — unresolved $ref
    - `org_public_data` OrgPublicData1 — unresolved $ref
    - `off_chrt_org_data` OffChrtOrgData1 — unresolved $ref
    - `accounts` Account1[] — unresolved $ref
  - `total_count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chrt/chrt-fastapi/revisions/ea04e157edb3/schema)