# Recupera un'organizzazione

`GET /fapi/v1/organizations/{org_id}` · chiamato dall'host di accesso dell'ambiente

Restituisce il profilo di un'organizzazione così come lo vede il suo amministratore: nome, slug, stato, colore del brand e versione. È ciò che mostra una schermata del profilo dell'organizzazione. Richiede il cookie `__Host-idp_session` dell'utente autenticato; se il cookie manca, è scaduto o è stato revocato, restituisce `401 unauthenticated`. Un'app first-party su un'altra origine può invece inviare il proprio access token dell'API front (`Authorization: DPoP <token>` con una prova DPoP; vedi [Access token dell'API front](/docs/api/fapi/front-api-token)). L'utente deve essere un membro attivo dell'organizzazione con l'autorizzazione `idp_org:read`. Un utente che non è membro riceve `404 not_found`, così l'esistenza dell'organizzazione non viene rivelata; un membro senza l'autorizzazione riceve `403 insufficient_permissions`.

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

## Richiesta

Header:

| Header | Obbligatorio | Descrizione |
| --- | --- | --- |
| `Idp-Client` | sì | Identificativo dell'SDK. |

`org_id`: l'identificativo dell'organizzazione (`org_…`).

Nessun corpo.

## Risposta

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

| Campo | Descrizione |
| --- | --- |
| `id` | `org_…`. |
| `name` | Nome visualizzato; mostralo come testo semplice. |
| `slug` | Lo slug dell'organizzazione. |
| `status` | `active`, `disabled` o `pending_deletion`. |
| `brand_color` | `#RRGGBB`, oppure `null` se non impostato. |
| `deletion_due_at` | Solo mentre l'organizzazione è in attesa di cancellazione: quando verrà cancellata. |
| `created_at`, `updated_at` | Orari RFC 3339. |
| `version` | La versione contenuta nell'`ETag`; inviala come `If-Match` in un aggiornamento. |

## Errori

| Stato | Codice | Quando |
| --- | --- | --- |
| 401 | `unauthenticated` | Cookie di sessione assente o non valido. |
| 403 | `insufficient_permissions` | L'utente non ha `idp_org:read` nell'organizzazione. |
| 404 | `not_found` | Nessuna organizzazione del genere per questo utente; un identificativo sconosciuto, malformato o di un'altra organizzazione riceve la stessa risposta. |
| 503 | `service_unavailable` | Temporaneamente non disponibile; riprova dopo `Retry-After`. |

## Esempio

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