Listar los dominios de la organización

GET /v1/organization-domains · permiso organization-domains:read

Lista los dominios de organización del entorno, del más antiguo al más reciente (orden por ID), con paginación por cursor. Solo se admite la paginación hacia adelante (after). Una página tiene de 1 a 100 elementos, 20 por defecto.

Solicitud

Campo Tipo Obligatorio Descripción
limit query no Tamaño de página, de 1 a 100 (predeterminado 20).
after query no Cursor de list_metadata.after de la página anterior.
organization_id query no Solo los dominios de esta organización (org_…).
domain query no Solo este dominio (Unicode o A-label, coincidencia exacta).
status query no Solo los dominios en este estado: pending, verified, unverified, expired o revoked.

Sin cuerpo de solicitud.

Respuesta

200 OK con una página de dominios.

{
  "data": [
    {
      "id": "odm_01j9xk3m7q8r2s4t6v8w0y2z4c",
      "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "domain": "acme.com",
      "status": "verified",
      "verification_method": "dns_txt",
      "txt_record_name": "_akp-verify.acme.com",
      "txt_record_value": "idp-verify=EXAMPLEtokenEXAMPLEtokenEXAMPLEtokenEXAMPLEtok",
      "verification_started_at": "2026-10-12T09:30:00.123456Z",
      "verified_at": "2026-10-12T09:35:00.654321Z",
      "last_checked_at": "2026-10-12T09:35:00.654321Z",
      "unverified_at": null,
      "next_check_at": "2026-10-13T09:35:00.654321Z",
      "last_failure_code": null,
      "capture_mode": "off",
      "sso_routing_enabled": false,
      "created_at": "2026-10-12T09:30:00.123456Z",
      "updated_at": "2026-10-12T09:35:00.654321Z",
      "version": 2
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Errores

HTTP code Cuándo
422 validation_failed Un filtro, limit o el cursor no es válido (no se admiten before ni un order distinto de asc).
401 unauthenticated La credencial falta, no es válida o fue revocada.
403 insufficient_permissions La credencial no tiene el permiso requerido.
429 rate_limited Se superó el límite de frecuencia; reintente después del período de Retry-After.
503 service_unavailable Una dependencia no está disponible temporalmente; reintente después del período de Retry-After.

Ejemplo

curl "https://api.eu.keenauth.com/v1/organization-domains?organization_id=org_01j9xk3m7q8r2s4t6v8w0y2z4a&status=verified" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"