GET /analyses/:profileId/analyses

Endpoint

GET /v1/analyses/{profileId}/analyses

Request

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	Description
`status`	`string`		Filter by analysis status: `pending`, `processing`, `completed`, `failed`
`sort`	`string`	`createdAt`	Sort field: `createdAt`, `completedAt`, `requestedAt`
`order`	`string`	`desc`	Sort order: `asc`, `desc`
`cursor`	`string`		Pagination cursor returned from a previous response
`limit`	`number`	`20`	Number of results per page (max 50)

Response (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"
    }
  ]
}

Response Fields

number

required

Total number of items in the current response page

string | null

required

Cursor for the next page. Pass this as the cursor query parameter to fetch the next page. null when there are no more results.

array

required

Array of analysis summary objects

Item Fields

string

required

Unique analysis ID (analysis_ prefix)

string

required

Profile ID this analysis belongs to

string | null

required

Target folder ID (null for full-profile analysis)

string | null

required

Engine ID used (null when using default engine)

string

required

Analysis status: pending / processing / completed / failed

string

required

System verdict for the analysis as a whole: verified / pending_review / rejected

object

required

Risk assessment summary

string

required

Risk level: low / medium / high / critical

number

required

Risk score (0–100, higher = riskier)

number

required

Processing time in milliseconds

string | null

required

Error message (null on success)

string

required

Analysis request time (ISO 8601)

string | null

required

Analysis completion time (ISO 8601, null if not completed)

string

required

Record creation time (ISO 8601)

Pagination

This endpoint uses cursor-based pagination. To retrieve all results:

Make the initial request without a cursor parameter.
If the response includes a non-null nextCursor, pass it as the cursor query parameter in the next request.
Repeat until nextCursor is null.

The list endpoint returns summary objects. To retrieve full analysis details including extracted data, findings, and audit logs, use GET /analyses/:analysisId.

Error Codes

Status	Code	Description
404	`PROFILE_NOT_FOUND`	The specified profile was not found

Overview

API Reference

GET /analyses/:profileId/analyses

Endpoint

Request

Query Parameters

Response (200 OK)

Response Fields

Item Fields

Error Codes

​Endpoint

​Request

​Query Parameters

​Response (200 OK)

​Response Fields

​Item Fields

​Pagination

​Error Codes

Endpoint

Request

Query Parameters

Response (200 OK)

Response Fields

Item Fields

Pagination

Error Codes