> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bottari.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 사용자 목록 읽기

> 팀 멤버와 활성 연동 봇을 읽습니다.

팀 멤버와 이 팀의 활성 연동 봇을 반환합니다. 사람이 먼저이고 봇이 그다음입니다. 게스트와 지운 연동의 봇은 목록에 없지만 [사용자 읽기](https://developers.bottari.ai/ko/api-reference/users/retrieve.md)로 읽을 수 있습니다.

`사용자 정보`가 `없음`이면 403입니다.

**Authorization** `string` *required*

`Bearer <토큰>` 형식입니다. [토큰 자세히 알아보기 →](https://developers.bottari.ai/ko/auth/tokens.md)

**Bottari-Version** `string`

선택 항목입니다. `2026-03-11`만 받습니다. 빼면 현재 버전을 사용하고, 다른 값을 보내면 400을 반환합니다.

**page\_size** `number` (default: 100)

1\~100입니다.

**start\_cursor** `string`

앞 응답의 `next_cursor`입니다.

**results** `object[]`

사용자 객체 목록입니다. 이름 · 아바타 · 이메일은 `사용자 정보` 권한에 따라 다릅니다. [사용자 정보 자세히 알아보기 →](https://developers.bottari.ai/ko/auth/capabilities.md#사용자-정보)

**next\_cursor** `string | null`

다음 목록의 커서입니다.

**has\_more** `boolean`

더 있으면 `true`입니다.

**type** `string`

항상 `user`입니다.

## 오류

| 상태 | `code` | 원인 |
| - | - | - |
| 400 | `validation_error` | `page_size`가 1\~100이 아닙니다. |
| 403 | `restricted_resource` | `사용자 정보`가 `없음`입니다. |

공통 오류는 [공통 규칙](https://developers.bottari.ai/ko/api-reference/overview.md#오류)에서 확인할 수 있습니다.

```bash curl theme={null}
curl "https://api.bottari.ai/v1/users?page_size=50" \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"
```

```json 200 theme={null}
{
  "object": "list",
  "results": [
    {
      "object": "user",
      "id": "11111111-1111-4111-8111-111111111111",
      "name": "김예시",
      "avatar_url": null,
      "type": "person",
      "person": {}
    },
    {
      "object": "user",
      "id": "22222222-2222-4222-8222-222222222222",
      "name": "주문 동기화",
      "avatar_url": null,
      "type": "bot",
      "bot": {}
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "type": "user",
  "user": {},
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```

```json 403 theme={null}
{
  "object": "error",
  "status": 403,
  "code": "restricted_resource",
  "message": "Insufficient permissions for this endpoint. This connection does not have user information capabilities.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.