# Listar mis organizaciones

`GET /fapi/v1/me/organizations` · llamado desde el host de inicio de sesión del entorno

Lista las organizaciones a las que el usuario autenticado puede cambiar en una aplicación: organizaciones en las que el usuario tiene una pertenencia activa, que están activas y para las que la aplicación está habilitada, en orden de slug, con un máximo de 100. Es la lista que muestra un selector de organización y la misma que ofrece el selector alojado de organizaciones al iniciar sesión, por lo que nunca muestra una organización que la aplicación no puede usar. Ningún elemento se marca como actual: la organización a la que está vinculado el token de tu aplicación es la claim `org_id` del token. La lectura no cambia nada y no requiere una sesión verificada recientemente. Requiere la cookie `__Host-idp_session` del usuario autenticado; si la cookie falta, ha caducado o ha sido revocada, devuelve `401 unauthenticated`.

Con `@keenauth/js`: `await keenauth.organizations.listMine()`.

## Solicitud

Encabezados:

| Encabezado | Obligatorio | Descripción |
| --- | --- | --- |
| `Idp-Client` | sí | Identificador del SDK. |

Parámetros de consulta:

| Parámetro | Obligatorio | Descripción |
| --- | --- | --- |
| `client_id` | sí | El `client_id` de la aplicación de primera parte en la que se ejecuta el selector. |

Sin cuerpo.

## Respuesta

`200 OK` con `{"data": [...], "truncated": false}`.

Cada elemento: `id` (`org_…`, la misma forma que la claim `org_id` del token y el parámetro `organization`), `slug`, `name` (nombre visible con los caracteres de control y bidireccionales eliminados; el slug cuando la organización no tiene nombre; muéstralo como texto plano). `truncated` es `true` cuando el usuario tiene más organizaciones de este tipo que las listadas.

## Errores

| Estado | Código | Cuándo |
| --- | --- | --- |
| 401 | `unauthenticated` | No hay una cookie de sesión válida. |
| 403 | `headless_not_allowed` | La aplicación es una aplicación de terceros. |
| 422 | `validation_failed` | `client_id` falta, está vacío, tiene más de 255 caracteres, se envía más de una vez o es desconocido (`/client_id`). |
| 503 | `temporarily_unavailable` | El directorio de pertenencias no respondió; vuelve a intentarlo más tarde. |

## Ejemplo

```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
}
```

## Datos personales

Este endpoint contiene datos personales: pertenencias a organizaciones e invitaciones. [Datos personales en las API de KeenAuth](/docs/policies/personal-data) describe qué se almacena, durante cuánto tiempo se conserva y cómo se elimina. No envíes categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.