# Elenca le mie organizzazioni

`GET /fapi/v1/me/organizations` · chiamato dall'host di accesso dell'ambiente

Elenca le organizzazioni a cui l'utente autenticato può passare in un'applicazione: organizzazioni in cui l'utente ha un'appartenenza attiva, che sono attive e per cui l'applicazione è abilitata, in ordine di slug, al massimo 100. È l'elenco che mostra un selettore di organizzazione e lo stesso elenco che il selettore ospitato delle organizzazioni propone all'accesso, quindi non mostra mai un'organizzazione che l'applicazione non può usare. Nessun elemento è contrassegnato come corrente: l'organizzazione a cui è legato il token della tua applicazione è indicata dall'attributo `org_id` del token. La lettura non modifica nulla e non richiede una sessione verificata di recente. Richiede il cookie `__Host-idp_session` dell'utente autenticato; se il cookie manca, è scaduto o è stato revocato, restituisce `401 unauthenticated`.

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

## Richiesta

Intestazioni:

| Intestazione | Obbligatoria | Descrizione |
| --- | --- | --- |
| `Idp-Client` | sì | Identificatore dell'SDK. |

Parametri di query:

| Parametro | Obbligatorio | Descrizione |
| --- | --- | --- |
| `client_id` | sì | Il `client_id` dell'applicazione di prima parte in cui gira il selettore. |

Nessun corpo.

## Risposta

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

Ogni elemento: `id` (`org_…`, nella stessa forma dell'attributo `org_id` del token e del parametro `organization`), `slug`, `name` (nome visualizzato con i caratteri di controllo e bidirezionali rimossi; lo slug quando l'organizzazione non ha un nome; visualizzalo come testo semplice). `truncated` è `true` quando l'utente ha più organizzazioni di questo tipo rispetto a quelle elencate.

## Errori

| Stato | Codice | Quando |
| --- | --- | --- |
| 401 | `unauthenticated` | Nessun cookie di sessione valido. |
| 403 | `headless_not_allowed` | L'applicazione è un'applicazione di terze parti. |
| 422 | `validation_failed` | `client_id` manca, è vuoto, supera i 255 caratteri, è fornito più di una volta o è sconosciuto (`/client_id`). |
| 503 | `temporarily_unavailable` | La directory delle appartenenze non ha risposto; riprova più tardi. |

## Esempio

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

## Dati personali

Questo endpoint tratta dati personali: appartenenze alle organizzazioni e inviti. [Dati personali nelle API di KeenAuth](/docs/policies/personal-data) descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene cancellato. Non inviare categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale) in nessun campo.