Listar dominios personalizados

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

Lista los dominios de inicio de sesión personalizados del entorno, del más antiguo al más reciente. Solo se admite la paginación hacia delante (after); before y cualquier order distinto de asc devuelven 422. Los dominios eliminados (released) se omiten salvo con include_released=true; status devuelve solo los dominios en ese estado (released incluido). Un entorno tiene como máximo 1 dominio personalizado (20 en Enterprise).

Solicitud

Campo Tipo Requerido Descripción
limit integer no Tamaño de página, 1-100 (por defecto 20).
after string no Cursor de list_metadata.after de la página anterior.
status string no Solo los dominios en este estado: pending_dns, issuing, active, degraded, disabled o released.
include_released boolean no Con true también se listan los dominios liberados. Se ignora cuando se indica status.

Sin cuerpo de solicitud.

Respuesta

200 OK con una página de dominios (los elementos de la lista no tienen el campo caa).

{
  "data": [
    {
      "id": "cdom_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "hostname": "login.example.com",
      "is_primary": true,
      "status": "active",
      "failure_reason": null,
      "dns_records": [
        {
          "type": "TXT",
          "name": "_akp-verify.login.example.com",
          "value": "idp-verify=3q2-7wEXAMPLEtokenQ9"
        },
        {
          "type": "CNAME",
          "name": "login.example.com",
          "value": "acme.eu.edge.keenauth.app"
        }
      ],
      "certificate_expires_at": "2027-01-04T09:31:12Z",
      "last_checked_at": "2026-10-05T09:31:00Z",
      "next_check_at": null,
      "activated_at": "2026-10-05T09:31:12Z",
      "degraded_since": null,
      "status_changed_at": "2026-10-05T09:31:12Z",
      "created_at": "2026-10-05T09:30:00.123456Z",
      "updated_at": "2026-10-05T09:31:12Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Errores

HTTP código Cuándo
422 invalid_cursor El cursor no es válido o pertenece a otro filtro.
422 validation_failed Un parámetro de consulta no es válido (before, order=desc, status desconocido).
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 periodo Retry-After.
503 service_unavailable Una dependencia no está disponible temporalmente; reintente después del periodo Retry-After.

Ejemplo

curl "https://api.eu.keenauth.com/v1/custom-domains?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"