# 내 조직 목록 조회

`GET /fapi/v1/me/organizations` · 환경의 로그인 호스트에서 호출

인증된 사용자가 하나의 애플리케이션에서 전환할 수 있는 조직을 slug 순서로 최대 100개까지 나열합니다. 나열되는 조직은 사용자가 활성 멤버십을 가지고 있고, 조직이 활성 상태이며, 애플리케이션이 해당 조직에 대해 사용 설정되어 있는 조직입니다. 이 목록은 조직 전환기에 표시되는 목록이자 호스팅된 조직 선택기가 로그인 시 제공하는 목록과 같으므로, 애플리케이션이 사용할 수 없는 조직은 표시되지 않습니다. 현재 조직으로 표시되는 항목은 없습니다. 애플리케이션 토큰이 연결된 조직은 토큰의 `org_id` 클레임입니다. 조회는 아무것도 변경하지 않으며 최근에 검증된 세션을 요구하지 않습니다. 인증된 사용자의 `__Host-idp_session` 쿠키가 필요하며, 쿠키가 없거나 만료되었거나 취소된 경우 `401 unauthenticated`를 반환합니다.

`@keenauth/js`를 사용하는 경우: `await keenauth.organizations.listMine()`.

## 요청

헤더:

| 헤더 | 필수 | 설명 |
| --- | --- | --- |
| `Idp-Client` | 예 | SDK 식별자. |

쿼리 매개변수:

| 매개변수 | 필수 | 설명 |
| --- | --- | --- |
| `client_id` | 예 | 조직 전환기가 실행되는 자사 애플리케이션의 `client_id`. |

본문 없음.

## 응답

`{"data": [...], "truncated": false}`와 함께 `200 OK`를 반환합니다.

각 항목: `id` (`org_…`, 토큰의 `org_id` 클레임 및 `organization` 매개변수와 같은 형식), `slug`, `name` (제어 문자와 양방향 문자를 제거한 표시 이름이며, 조직에 이름이 없으면 slug를 사용합니다. 일반 텍스트로 렌더링하십시오). 사용자에게 나열된 수보다 더 많은 해당 조직이 있으면 `truncated`는 `true`입니다.

## 오류

| 상태 | 코드 | 발생 조건 |
| --- | --- | --- |
| 401 | `unauthenticated` | 유효한 세션 쿠키가 없습니다. |
| 403 | `headless_not_allowed` | 애플리케이션이 제3자 애플리케이션입니다. |
| 422 | `validation_failed` | `client_id`가 없거나, 비어 있거나, 255자보다 길거나, 두 번 이상 전달되었거나, 알 수 없는 값입니다(`/client_id`). |
| 503 | `temporarily_unavailable` | 멤버십 디렉터리가 응답하지 않았습니다. 나중에 다시 시도하십시오. |

## 예시

```bash
curl "https://example.keenauth.app/fapi/v1/me/organizations?client_id=app_01j9zzzzzzzzzzzzzzzzzzzz" \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt
```

```json
{
  "data": [
    {
      "id": "org_01j9xxxxxxxxxxxxxxxxxxxxxx",
      "slug": "acme",
      "name": "Acme"
    }
  ],
  "truncated": false
}
```

## 개인정보

이 엔드포인트는 개인정보를 다룹니다: 조직 멤버십과 초대. [KeenAuth API의 개인정보](/docs/policies/personal-data)에서 저장되는 항목, 보관 기간, 삭제 방법을 설명합니다. 어떤 필드에도 민감정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.