> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /analyses/:profileId/analyses

> Liste los análisis de un profile con filtros, orden y paginación por cursor.

## Endpoint

```
GET /v1/analyses/{profileId}/analyses
```

## Solicitud

```bash theme={null}
curl -X GET "http://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     | Required | 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)

```json theme={null}
{
  "count": 3,
  "nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI1LTA1LTAxVDEyOjAwOjAwWiJ9",
  "items": [
    {
      "id": "analysis_abc123",
      "profileId": "profile_xyz789",
      "folderId": null,
      "engineId": null,
      "status": "completed",
      "verificationStatus": "approved",
      "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

<ResponseField name="count" type="number" required>
  Número total de elementos en la página actual de la respuesta
</ResponseField>

<ResponseField name="nextCursor" type="string | null" required>
  Cursor para la siguiente página. Páselo como parámetro `cursor` en la siguiente solicitud. `null` cuando no hay más resultados.
</ResponseField>

<ResponseField name="items" type="array" required>
  Array de objetos resumen de análisis
</ResponseField>

### Campos del item

<ResponseField name="id" type="string" required>
  ID único del análisis (prefijo `analysis_`)
</ResponseField>

<ResponseField name="profileId" type="string" required>
  ID del profile al que pertenece este análisis
</ResponseField>

<ResponseField name="folderId" type="string | null" required>
  ID del folder objetivo (`null` para análisis de profile completo)
</ResponseField>

<ResponseField name="engineId" type="string | null" required>
  ID del engine utilizado (`null` cuando se usa el engine predeterminado)
</ResponseField>

<ResponseField name="status" type="string" required>
  Estado del análisis: `pending` / `processing` / `completed` / `failed`
</ResponseField>

<ResponseField name="verificationStatus" type="string" required>
  Estado final de verificación: `pending_review` / `approved` / `rejected`
</ResponseField>

<ResponseField name="riskAssessment" type="object" required>
  Resumen de evaluación de riesgo
</ResponseField>

<ResponseField name="riskAssessment.riskLevel" type="string" required>
  Nivel de riesgo: `low` / `medium` / `high`
</ResponseField>

<ResponseField name="riskAssessment.riskScore" type="number" required>
  Puntuación de riesgo (0-100, mayor = más riesgoso)
</ResponseField>

<ResponseField name="processingTimeMs" type="number" required>
  Tiempo de procesamiento en milisegundos
</ResponseField>

<ResponseField name="error" type="string | null" required>
  Mensaje de error (`null` si fue exitoso)
</ResponseField>

<ResponseField name="requestedAt" type="string" required>
  Hora de solicitud del análisis (ISO 8601)
</ResponseField>

<ResponseField name="completedAt" type="string | null" required>
  Hora de finalización del análisis (ISO 8601, `null` si no se ha completado)
</ResponseField>

<ResponseField name="createdAt" type="string" required>
  Hora de creación del registro (ISO 8601)
</ResponseField>

***

## Paginación

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

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

<Note>
  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](/es/omni/api-reference/get-analysis).
</Note>

***

## Códigos de error

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