# Obtener una organización

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

Devuelve el perfil de una organización tal como lo ve su administrador: nombre, slug, estado, color de marca y versión. Esto es lo que muestra una pantalla de perfil de organización. Requiere la cookie `__Host-idp_session` del usuario autenticado; si la cookie falta, ha caducado o ha sido revocada, devuelve `401 unauthenticated`. Una aplicación de primera parte en otro origen puede enviar en su lugar su token de acceso de la API frontal (`Authorization: DPoP <token>` con una prueba DPoP; consulte [Token de acceso de la API frontal](/docs/api/fapi/front-api-token)). El usuario debe ser miembro activo de la organización con el permiso `idp_org:read`. Un usuario que no es miembro recibe `404 not_found`, de modo que no se revela la existencia de la organización; un miembro sin el permiso recibe `403 insufficient_permissions`.

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

## Solicitud

Encabezados:

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

`org_id`: el identificador de la organización (`org_…`).

Sin cuerpo.

## Respuesta

`200 OK` con `ETag: "<versión>"`.

| Campo | Descripción |
| --- | --- |
| `id` | `org_…`. |
| `name` | Nombre para mostrar; muéstrelo como texto sin formato. |
| `slug` | El slug de la organización. |
| `status` | `active`, `disabled` o `pending_deletion`. |
| `brand_color` | `#RRGGBB`, o `null` si no está definido. |
| `deletion_due_at` | Solo mientras la organización está pendiente de eliminación: cuándo se eliminará. |
| `created_at`, `updated_at` | Fechas RFC 3339. |
| `version` | La versión que lleva el `ETag`; envíela como `If-Match` en una actualización. |

## Errores

| Estado | Código | Cuándo |
| --- | --- | --- |
| 401 | `unauthenticated` | No hay una cookie de sesión válida. |
| 403 | `insufficient_permissions` | El usuario no tiene `idp_org:read` en la organización. |
| 404 | `not_found` | No existe tal organización para este usuario; un identificador desconocido, con formato incorrecto o ajeno recibe la misma respuesta. |
| 503 | `service_unavailable` | No disponible temporalmente; reintente después de `Retry-After`. |

## Ejemplo

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