# Lister mes organisations

`GET /fapi/v1/me/organizations` · appelé depuis l'hôte de connexion de l'environnement

Liste les organisations vers lesquelles l'utilisateur authentifié peut basculer dans une application : les organisations dans lesquelles l'utilisateur a une appartenance active, qui sont actives et pour lesquelles l'application est activée, triées par slug, au maximum 100. C'est la liste qu'affiche un sélecteur d'organisation, et la même liste que propose le sélecteur d'organisation hébergé lors de la connexion ; elle n'affiche donc jamais une organisation que l'application ne peut pas utiliser. Aucun élément n'est marqué comme courant : l'organisation à laquelle le jeton de votre application est lié est indiquée par la revendication `org_id` du jeton. La lecture ne modifie rien et ne nécessite pas une session vérifiée récemment. Nécessite le cookie `__Host-idp_session` de l'utilisateur authentifié ; si le cookie est absent, expiré ou révoqué, renvoie `401 unauthenticated`.

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

## Requête

En-têtes :

| En-tête | Obligatoire | Description |
| --- | --- | --- |
| `Idp-Client` | oui | Identifiant du SDK. |

Paramètres de requête :

| Paramètre | Obligatoire | Description |
| --- | --- | --- |
| `client_id` | oui | Le `client_id` de l'application de première partie dans laquelle s'exécute le sélecteur. |

Pas de corps.

## Réponse

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

Chaque élément : `id` (`org_…`, sous la même forme que la revendication `org_id` du jeton et que le paramètre `organization`), `slug`, `name` (nom d'affichage dont les caractères de contrôle et bidirectionnels ont été supprimés ; le slug lorsque l'organisation n'a pas de nom ; à afficher comme texte brut). `truncated` vaut `true` lorsque l'utilisateur possède davantage de ces organisations que celles listées.

## Erreurs

| Statut | Code | Quand |
| --- | --- | --- |
| 401 | `unauthenticated` | Aucun cookie de session valide. |
| 403 | `headless_not_allowed` | L'application est une application tierce. |
| 422 | `validation_failed` | `client_id` est absent, vide, dépasse 255 caractères, est fourni plusieurs fois ou est inconnu (`/client_id`). |
| 503 | `temporarily_unavailable` | L'annuaire des appartenances n'a pas répondu ; réessayez plus tard. |

## Exemple

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

## Données personnelles

Cet point de terminaison traite des données personnelles : appartenances aux organisations et invitations. [Données personnelles dans les API KeenAuth](/docs/policies/personal-data) décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. N'envoyez pas de catégories particulières de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.