GET /analyses/:profileId/analyses

Endpoint

GET /v1/analyses/{profileId}/analyses

Solicitud

curl -X GET "https://client-omni-api.argosidentity.com/v1/analyses/{profileId}/analyses?status=completed&sort=createdAt&order=desc&limit=20" \
  -H "x-api-key: your-api-key-here"

Query Parameters

Parameter	Type	Default	Descripción
`status`	`string`		Filtrar por estado del análisis: `pending`, `processing`, `completed`, `failed`
`sort`	`string`	`createdAt`	Campo de ordenación: `createdAt`, `completedAt`, `requestedAt`
`order`	`string`	`desc`	Orden: `asc`, `desc`
`cursor`	`string`		Cursor de paginación de la respuesta anterior
`limit`	`number`	`20`	Número de resultados por página (máx. 50)

Respuesta (200 OK)

{
  "count": 3,
  "nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI1LTA1LTAxVDEyOjAwOjAwWiJ9",
  "items": [
    {
      "id": "analysis_8k2m4p9x1q3z",
      "profileId": "pf_3n7v2c5w8k1d",
      "folderId": null,
      "engineId": null,
      "status": "completed",
      "verificationStatus": "verified",
      "riskAssessment": {
        "riskLevel": "low",
        "riskScore": 12
      },
      "processingTimeMs": 4523,
      "error": null,
      "requestedAt": "2025-05-01T12:00:00Z",
      "completedAt": "2025-05-01T12:00:04Z",
      "createdAt": "2025-05-01T12:00:00Z"
    }
  ]
}

Campos de la respuesta

number

requerido

Número total de elementos en la página actual de la respuesta

string | null

requerido

Cursor para la siguiente página. Páselo como parámetro cursor en la siguiente solicitud. null cuando no hay más resultados.

array

requerido

Array de objetos resumen de análisis

Campos del item

string

requerido

ID único del análisis (prefijo analysis_)

string

requerido

ID del profile al que pertenece este análisis

string | null

requerido

ID del folder objetivo (null para análisis de profile completo)

string | null

requerido

ID del engine utilizado (null cuando se usa el engine predeterminado)

string

requerido

Estado del análisis: pending / processing / completed / failed

string

requerido

Veredicto del sistema para el análisis completo: verified / pending_review / rejected

object

requerido

Resumen de evaluación de riesgo

string

requerido

Nivel de riesgo: low / medium / high / critical

number

requerido

Puntuación de riesgo (0-100, mayor = más riesgoso)

number

requerido

Tiempo de procesamiento en milisegundos

string | null

requerido

Mensaje de error (null si fue exitoso)

string

requerido

Hora de solicitud del análisis (ISO 8601)

string | null

requerido

Hora de finalización del análisis (ISO 8601, null si no se ha completado)

string

requerido

Hora de creación del registro (ISO 8601)

Paginación

Este endpoint utiliza paginación basada en cursor. Para recuperar todos los resultados:

Realice la solicitud inicial sin el parámetro cursor.
Si la respuesta incluye un nextCursor no nulo, páselo como parámetro cursor en la siguiente solicitud.
Repita hasta que nextCursor sea null.

El endpoint de lista devuelve objetos resumen. Para recuperar los detalles completos del análisis, incluyendo extracted data, findings y audit logs, use GET /analyses/:analysisId.

Códigos de error

Status	Code	Descripción
404	`PROFILE_NOT_FOUND`	El profile especificado no fue encontrado

Descripción General

Referencia API

GET /analyses/:profileId/analyses

Endpoint

Solicitud

Query Parameters

Respuesta (200 OK)

Campos de la respuesta

Campos del item

Paginación

Códigos de error

​Endpoint

​Solicitud

​Query Parameters

​Respuesta (200 OK)

​Campos de la respuesta

​Campos del item

​Paginación

​Códigos de error

Endpoint

Solicitud

Query Parameters

Respuesta (200 OK)

Campos de la respuesta

Campos del item

Paginación

Códigos de error