# Obtenir une organisation

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

Renvoie le profil d'une organisation tel que le voit son administrateur : nom, slug, statut, couleur de marque et version. C'est ce qu'affiche un écran de profil d'organisation. Le cookie `__Host-idp_session` de l'utilisateur authentifié est requis ; si le cookie est absent, expiré ou révoqué, la réponse est `401 unauthenticated`. Une application de première partie sur une autre origine peut à la place envoyer son jeton d'accès à l'API front (`Authorization: DPoP <token>` avec une preuve DPoP ; voir [Jeton d'accès à l'API front](/docs/api/fapi/front-api-token)). L'utilisateur doit être un membre actif de l'organisation disposant de l'autorisation `idp_org:read`. Un utilisateur qui n'est pas membre reçoit `404 not_found`, afin de ne pas révéler l'existence de l'organisation ; un membre sans l'autorisation reçoit `403 insufficient_permissions`.

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

## Requête

En-têtes :

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

`org_id` : l'identifiant de l'organisation (`org_…`).

Aucun corps.

## Réponse

`200 OK` avec `ETag: "<version>"`.

| Champ | Description |
| --- | --- |
| `id` | `org_…`. |
| `name` | Nom affiché ; affichez-le en texte brut. |
| `slug` | Le slug de l'organisation. |
| `status` | `active`, `disabled` ou `pending_deletion`. |
| `brand_color` | `#RRGGBB`, ou `null` si non défini. |
| `deletion_due_at` | Uniquement pendant que l'organisation est en attente de suppression : date à laquelle elle sera supprimée. |
| `created_at`, `updated_at` | Dates au format RFC 3339. |
| `version` | La version portée par l'`ETag` ; envoyez-la dans `If-Match` lors d'une mise à jour. |

## Erreurs

| Statut | Code | Quand |
| --- | --- | --- |
| 401 | `unauthenticated` | Aucun cookie de session valide. |
| 403 | `insufficient_permissions` | L'utilisateur ne dispose pas de `idp_org:read` dans l'organisation. |
| 404 | `not_found` | Aucune organisation de ce type pour cet utilisateur ; un identifiant inconnu, mal formé ou appartenant à une autre organisation donne la même réponse. |
| 503 | `service_unavailable` | Temporairement indisponible ; réessayez après `Retry-After`. |

## Exemple

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

```json
{
  "id": "org_01jbz6x8kq3m2n4p5r6s7t8v9a",
  "name": "Acme",
  "slug": "acme",
  "status": "active",
  "brand_color": "#112233",
  "created_at": "2026-11-03T09:00:00Z",
  "updated_at": "2026-11-03T09:30:00Z",
  "version": 4
}
```