GET /analyses/:profileId/analyses - ARGOS Identity

요약 객체만 반환합니다. 추출 데이터·감사 로그까지 필요하면 분석 상세 조회를 사용하세요.

엔드포인트

GET /v1/analyses/{profileId}/analyses

요청

경로 파라미터

파라미터	타입	설명
`profileId`	`string`	조회할 프로파일 ID (`pf_` 접두사)

쿼리 파라미터

파라미터	타입	기본값	설명
`status`	`string`		상태 필터: `pending` · `processing` · `completed` · `failed`
`sort`	`string`	`createdAt`	`createdAt` · `completedAt` · `requestedAt`
`order`	`string`	`desc`	`asc` · `desc`
`cursor`	`string`		이전 페이지의 마지막 항목 `id`. 그 분석 다음부터 반환
`limit`	`number`	20	페이지당 항목 수(최대 50)

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

응답 (200 OK)

{
  "count": 2,
  "items": [
    {
      "id": "analysis_lghgsxkorvoc",
      "profileId": "pf_0twd91ioowfr",
      "folderId": null,
      "engineId": null,
      "status": "completed",
      "verificationStatus": "verified",
      "confidenceScore": 0.92,
      "riskAssessment": { "riskLevel": "low", "riskScore": 25 },
      "processingTimeMs": 132480,
      "error": null,
      "requestedAt": "2026-09-09T09:11:04.220Z",
      "completedAt": "2026-09-09T09:13:16.700Z",
      "createdAt": "2026-09-09T09:11:04.220Z"
    },
    {
      "id": "analysis_3c7v9b2n5m8k",
      "profileId": "pf_0twd91ioowfr",
      "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-09T08:20:11.532Z",
      "completedAt": null,
      "createdAt": "2026-09-09T08:20:11.532Z"
    }
  ]
}

응답 필드

필드	타입	설명
`count`	`number`	이번 페이지의 항목 수
`items[].id`	`string`	분석 ID (`analysis_` 접두사)
`items[].profileId`	`string`	소속 프로파일 ID
`items[].folderId`	`string \| null`	대상 폴더 ID. 프로파일 전체 분석이면 `null`
`items[].engineId`	`string \| null`	사용된 엔진 ID. 기본값이면 `null`
`items[].status`	`string`	`pending` · `processing` · `completed` · `failed`
`items[].verificationStatus`	`string \| null`	시스템 판정: `verified` · `pending_review` · `rejected`. 미완료·실패면 `null`
`items[].confidenceScore`	`number \| null`	판정 신뢰도(0.0–1.0). 상세 응답의 `confidence`(Analysis Score)와는 다른 지표
`items[].riskAssessment`	`object \| null`	위험도 요약. 미산출이면 `null`
`items[].riskAssessment.riskLevel`	`string`	`low` · `medium` · `high` · `critical`
`items[].riskAssessment.riskScore`	`number`	0–100. 높을수록 위험
`items[].processingTimeMs`	`number \| null`	처리 소요 시간(밀리초). 미완료면 `null`
`items[].error`	`object \| null`	실패 시 `code`·`message`. 정상이면 `null`
`items[].requestedAt`	`string`	요청 시각
`items[].completedAt`	`string \| null`	완료 시각. 미완료면 `null`
`items[].createdAt`	`string`	레코드 생성 시각

판정과 점수를 어떻게 읽는지는 분석 결과 읽기를 참조하세요.

페이지네이션

이 엔드포인트의 커서는 별도 토큰이 아니라 **분석 id**입니다. 응답에 nextCursor 필드가 없습니다.

cursor 없이 첫 요청을 보냅니다.
items의 **마지막 항목 id**를 다음 요청의 cursor로 전달합니다.
count가 limit보다 작아지면 마지막 페이지입니다.

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

에러 코드

상태	코드	설명
404	`OMNI_3005`	프로파일을 찾을 수 없음

공통 에러(400 요청 검증 · 401 인증 · 403 권한 · 500 서버 오류)는 API 개요를 참조하세요.

⌘I