> ## 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

> 프로필의 모든 분석 목록을 필터링, 정렬, 커서 기반 페이지네이션으로 조회합니다.

## Endpoint

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

## 요청

```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"
```

## 쿼리 파라미터

| 파라미터     | 타입       | 필수 | 기본값         | 설명                                                         |
| -------- | -------- | -- | ----------- | ---------------------------------------------------------- |
| `status` | `string` |    |             | 분석 상태로 필터링: `pending`, `processing`, `completed`, `failed` |
| `sort`   | `string` |    | `createdAt` | 정렬 기준 필드: `createdAt`, `completedAt`, `requestedAt`        |
| `order`  | `string` |    | `desc`      | 정렬 순서: `asc`, `desc`                                       |
| `cursor` | `string` |    |             | 이전 응답에서 반환된 페이지네이션 커서                                      |
| `limit`  | `number` |    | `20`        | 페이지당 결과 수 (최대 50)                                          |

***

## 응답 (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"
    }
  ]
}
```

***

## 응답 필드

<ResponseField name="count" type="number" required>
  현재 응답 페이지의 총 아이템 수
</ResponseField>

<ResponseField name="nextCursor" type="string | null" required>
  다음 페이지를 위한 커서입니다. 다음 요청 시 `cursor` 쿼리 파라미터로 전달하세요. 더 이상 결과가 없으면 `null`입니다.
</ResponseField>

<ResponseField name="items" type="array" required>
  분석 요약 객체 배열
</ResponseField>

### 아이템 필드

<ResponseField name="id" type="string" required>
  분석 고유 ID (`analysis_` 접두사)
</ResponseField>

<ResponseField name="profileId" type="string" required>
  이 분석이 속한 프로필 ID
</ResponseField>

<ResponseField name="folderId" type="string | null" required>
  대상 폴더 ID (전체 프로필 분석 시 `null`)
</ResponseField>

<ResponseField name="engineId" type="string | null" required>
  사용된 엔진 ID (기본 엔진 사용 시 `null`)
</ResponseField>

<ResponseField name="status" type="string" required>
  분석 상태: `pending` / `processing` / `completed` / `failed`
</ResponseField>

<ResponseField name="verificationStatus" type="string" required>
  최종 검증 상태: `pending_review` / `approved` / `rejected`
</ResponseField>

<ResponseField name="riskAssessment" type="object" required>
  위험도 평가 요약
</ResponseField>

<ResponseField name="riskAssessment.riskLevel" type="string" required>
  위험 등급: `low` / `medium` / `high`
</ResponseField>

<ResponseField name="riskAssessment.riskScore" type="number" required>
  위험 점수 (0–100, 높을수록 위험)
</ResponseField>

<ResponseField name="processingTimeMs" type="number" required>
  처리 소요 시간 (밀리초)
</ResponseField>

<ResponseField name="error" type="string | null" required>
  에러 메시지 (정상 완료 시 `null`)
</ResponseField>

<ResponseField name="requestedAt" type="string" required>
  분석 요청 시각 (ISO 8601)
</ResponseField>

<ResponseField name="completedAt" type="string | null" required>
  분석 완료 시각 (ISO 8601, 미완료 시 `null`)
</ResponseField>

<ResponseField name="createdAt" type="string" required>
  레코드 생성 시각 (ISO 8601)
</ResponseField>

***

## 페이지네이션

이 엔드포인트는 **커서 기반 페이지네이션**을 사용합니다. 모든 결과를 조회하려면 다음과 같이 합니다:

1. `cursor` 파라미터 없이 첫 번째 요청을 보냅니다.
2. 응답에 `null`이 아닌 `nextCursor`가 포함된 경우, 다음 요청의 `cursor` 쿼리 파라미터로 전달합니다.
3. `nextCursor`가 `null`이 될 때까지 반복합니다.

<Note>
  목록 엔드포인트는 요약 객체를 반환합니다. 추출 데이터, 검증 결과, 감사 로그를 포함한 전체 분석 상세 정보를 조회하려면 [GET /analyses/:analysisId](/ko/omni/api-reference/get-analysis)를 사용하세요.
</Note>

***

## 에러 코드

| Status | Code                | 설명                 |
| ------ | ------------------- | ------------------ |
| 404    | `PROFILE_NOT_FOUND` | 지정된 프로필을 찾을 수 없습니다 |