GET /analyses/:profileId/analyses

Devuelve solo objetos de resumen. Cuando también necesite los datos extraídos y el registro de auditoría, use leer análisis.

Endpoint

GET /v1/analyses/{profileId}/analyses

Petición

Parámetros de ruta

Parámetro	Tipo	Descripción
`profileId`	`string`	ID del perfil a leer (prefijo `pf_`)

Parámetros de consulta

Parámetro	Tipo	Por defecto	Descripción
`status`	`string`		Filtro por estado: `pending` · `processing` · `completed` · `failed`
`sort`	`string`	`createdAt`	`createdAt` · `completedAt` · `requestedAt`
`order`	`string`	`desc`	`asc` · `desc`
`cursor`	`string`		El `id` del último elemento de la página anterior. Los resultados continúan a partir de ese análisis
`limit`	`number`	20	Elementos por página (máx. 50)

curl "https://client-omni-api.argosidentity.com/v1/analyses/pf_6h4y8s2f0v9n/analyses?status=completed&limit=20" \
  -H "x-api-key: your-api-key-here"

Respuesta (200 OK)

{
  "count": 2,
  "items": [
    {
      "id": "analysis_lsc7icgm9cjd",
      "profileId": "pf_6h4y8s2f0v9n",
      "folderId": null,
      "engineId": null,
      "status": "completed",
      "verificationStatus": "verified",
      "confidenceScore": 0.92,
      "riskAssessment": { "riskLevel": "low", "riskScore": 25 },
      "processingTimeMs": 132480,
      "error": null,
      "requestedAt": "2026-09-10T05:41:09.220Z",
      "completedAt": "2026-09-10T05:43:21.700Z",
      "createdAt": "2026-09-10T05:41:09.220Z"
    },
    {
      "id": "analysis_3c7v9b2n5m8k",
      "profileId": "pf_6h4y8s2f0v9n",
      "folderId": null,
      "engineId": null,
      "status": "failed",
      "verificationStatus": null,
      "confidenceScore": null,
      "riskAssessment": null,
      "processingTimeMs": null,
      "error": {
        "code": "ANALYSIS_PROCESSING_FAILED",
        "message": "Agent loop exceeded maximum iterations"
      },
      "requestedAt": "2026-09-10T05:20:11.532Z",
      "completedAt": null,
      "createdAt": "2026-09-10T05:20:11.532Z"
    }
  ]
}

Campos de la respuesta

Campo	Tipo	Descripción
`count`	`number`	Número de elementos en esta página
`items[].id`	`string`	ID del análisis (prefijo `analysis_`)
`items[].profileId`	`string`	ID del perfil al que pertenece
`items[].folderId`	`string \| null`	ID de la carpeta objetivo. `null` si se analizó el perfil completo
`items[].engineId`	`string \| null`	ID del motor utilizado. `null` para el valor por defecto
`items[].status`	`string`	`pending` · `processing` · `completed` · `failed`
`items[].verificationStatus`	`string \| null`	Veredicto del sistema: `verified` · `pending_review` · `rejected`. `null` si está incompleto o falló
`items[].confidenceScore`	`number \| null`	Confianza en el veredicto (0.0–1.0). Una medida distinta de `confidence` (Analysis Score) en la respuesta de detalle
`items[].riskAssessment`	`object \| null`	Resumen de riesgo. `null` si no se calculó
`items[].riskAssessment.riskLevel`	`string`	`low` · `medium` · `high` · `critical`
`items[].riskAssessment.riskScore`	`number`	0–100. Cuanto más alto, mayor riesgo
`items[].processingTimeMs`	`number \| null`	Tiempo de procesamiento en milisegundos. `null` si está incompleto
`items[].error`	`object \| null`	`code` y `message` en caso de fallo. `null` en el resto de casos
`items[].requestedAt`	`string`	Fecha de solicitud del análisis
`items[].completedAt`	`string \| null`	Fecha de finalización. `null` si está incompleto
`items[].createdAt`	`string`	Fecha de creación del registro

Cómo leer el veredicto y las puntuaciones está en leer resultados de análisis.

Paginación

El cursor de este endpoint es un id de análisis, no un token aparte. La respuesta no tiene campo nextCursor.

Envíe la primera petición sin cursor.
Pase el id de la última entrada de items como cursor en la siguiente petición.
Cuando count sea menor que limit, está en la última página.

curl "https://client-omni-api.argosidentity.com/v1/analyses/pf_6h4y8s2f0v9n/analyses?limit=20&cursor=analysis_3c7v9b2n5m8k" \
  -H "x-api-key: your-api-key-here"

Códigos de error

Estado	Código	Descripción
404	`OMNI_3005`	Perfil no encontrado

Los errores comunes (400 validación · 401 autenticación · 403 permisos · 500 servidor) están en la descripción general de la API.

Descripción General

Referencia API

GET /analyses/:profileId/analyses

Endpoint

Petición

Parámetros de ruta

Parámetros de consulta

Respuesta (200 OK)

Campos de la respuesta

Paginación

Códigos de error

​Endpoint

​Petición

​Parámetros de ruta

​Parámetros de consulta

​Respuesta (200 OK)

​Campos de la respuesta

​Paginación

​Códigos de error

Endpoint

Petición

Parámetros de ruta

Parámetros de consulta

Respuesta (200 OK)

Campos de la respuesta

Paginación

Códigos de error