> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # AML 모니터링 작업 조회 API > Didit에서 users 또는 businesses 엔드포인트로 시작한 지속적인 AML 모니터링 작업의 상태, 결과 카운터, 레코드별 결과를 폴링합니다. AML 모니터링 작업 조회 프롬프트 프롬프트를 클립보드에 복사 \

\`Goal: Read the status and the per-record results of an AML ongoing monitoring job started with POST /v3/users/aml-monitoring/ or POST /v3/businesses/aml-monitoring/. Needed whenever the toggle call returned 202 (more than 20 profiles); also works for jobs that already completed inline.

Endpoint: GET https://verification.didit.me/v3/aml-monitoring/jobs/{job_id}/
Auth header: x-api-key: 

Path param:
\- job_id: the job_id returned by the toggle endpoint.

curl:
curl 'https://verification.didit.me/v3/aml-monitoring/jobs/JOB_ID/' \
-H 'x-api-key: YOUR_API_KEY'

Response 200:
\{
"job_id": "",
"status": "PROCESSING",            // PENDING | PROCESSING | COMPLETED | FAILED
"is_enabled": true,
"target_type": "user",             // user | business
"total": 120,
"processed": 40,
"outcomes": {"enabled": 12, "screened_and_enabled": 25, "already_enabled": 3, "disabled": 0, "skipped_no_identity_data": 0, "skipped_blocked": 0, "skipped_sandbox": 0, "failed_provider": 0, "failed_insufficient_balance": 0},
"results": [
\{"didit_internal_id": "", "vendor_data": "user-123", "outcome": "enabled"},
...one entry per processed profile, in processing order...
],
"error": null,                     // generic message when status is FAILED
"created_at": "",
"completed_at": null
}

Polling: request the job every couple of seconds while status is PENDING or PROCESSING. results grows as profiles are processed and is complete once status is COMPLETED. A FAILED job keeps the results recorded before the failure and carries a short generic message in error; re-send the toggle request for the profiles that have no result yet. Per-record results are recorded for jobs started through the API; a job started from the Business Console reports counters only.

Failure modes:
\- 401 - missing/invalid x-api-key.
\- 404 - no such job for this application (jobs are only visible to the application that created them).

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.`

\
붙여넣을 곳 ## 개요[사용자에 대한 AML 모니터링 전환](https://docs.didit.me/ko/management-api/aml-monitoring/toggle-users.md) 또는 [기업에 대한 AML 모니터링 전환](https://docs.didit.me/ko/management-api/aml-monitoring/toggle-businesses.md)으로 시작한 지속적인 AML 모니터링 작업의 상태, 결과 값별 카운터, 처리된 사용자 또는 기업마다 하나씩 있는 `results` 항목을 반환합니다.20개를 초과하는 프로필을 선택하면 작업은 백그라운드에서 실행되며, 전환 호출은 `202`와 `PENDING` 작업을 반환합니다. `status`가 `COMPLETED` 또는 `FAILED`가 될 때까지 몇 초마다 이 endpoint를 폴링하세요. `results`는 프로필이 처리되는 순서대로 채워지며, 작업이 `COMPLETED` 상태가 되면 완료됩니다. 레코드별 결과는 API를 통해 시작한 작업에 대해서만 기록됩니다. Business Console에서 시작한 작업은 카운터만 보고합니다.## 작업 상태| `status` | 의미 | | - | - | | `PENDING` | 접수되었으며 아직 시작되지 않았습니다. | | `PROCESSING` | 실행 중입니다. `processed`, `outcomes`, `results`가 업데이트되고 있습니다. | | `COMPLETED` | 모든 프로필에 결과가 있습니다. | | `FAILED` | 작업이 중간에 중단되었습니다. `error`에는 짧은 일반 메시지가 담기며, 실패 이전에 기록된 결과는 유지됩니다. 아직 결과가 없는 프로필에 대해 전환 요청을 다시 보내세요. |레코드별 `outcome` 값은 전환 페이지에 문서화되어 있습니다.## 권한애플리케이션의 모든 활성 API 키는 이 endpoint를 호출할 수 있습니다. 작업은 이를 생성한 애플리케이션에만 보이며, 다른 `job_id`를 사용하면 `404`가 반환됩니다.## 관련 항목- [사용자에 대한 AML 모니터링 전환](https://docs.didit.me/ko/management-api/aml-monitoring/toggle-users.md) - [기업에 대한 AML 모니터링 전환](https://docs.didit.me/ko/management-api/aml-monitoring/toggle-businesses.md) - [지속적인 AML 모니터링](https://docs.didit.me/ko/core-technology/aml-screening/continuous-monitoring-aml-screening.md) ## OpenAPI ````yaml ko/openapi-25.json GET /v3/aml-monitoring/jobs/{job_id}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: 신분증 인증 API입니다. x-api-key 헤더로 인증합니다. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/aml-monitoring/jobs/{job_id}/: get: tags: - AML Ongoing Monitoring summary: 지속적인 AML 모니터링 작업 조회 description: >- `POST /v3/users/aml-monitoring/` 또는 `POST /v3/businesses/aml-monitoring/`에서 시작된 모니터링 토글 작업의 상태, 결과 카운터 및 레코드별 결과입니다. `status`가 `PENDING` 또는 `PROCESSING`인 동안 몇 초마다 폴링하십시오. `COMPLETED`가 되면 `results`가 완료됩니다. operationId: get_aml_monitoring_job parameters: - name: job_id in: path required: true schema: type: string format: uuid description: 토글 endpoint에서 반환된 `job_id`입니다. responses: '200': description: 작업입니다. content: application/json: schema: type: object properties: job_id: type: string format: uuid status: type: string enum: - PENDING - PROCESSING - COMPLETED - FAILED is_enabled: type: boolean description: 작업이 모니터링을 활성화하면 true, 비활성화하면 false입니다. target_type: type: string enum: - user - business description: 작업이 전환하는 프로필 패밀리입니다. total: type: integer description: 작업이 처리하는 프로필 수입니다. processed: type: integer description: 지금까지 처리된 프로필 수입니다. outcomes: type: object description: >- 레코드별 결과 카운터입니다. 선택된 모든 프로필은 정확히 하나의 카운터에 해당하며, 암묵적으로 건너뛰는 프로필은 없습니다. properties: enabled: type: integer description: 기존 AML 스크리닝에서 모니터링이 활성화되었습니다. screened_and_enabled: type: integer description: 새로운 AML 스크리닝이 생성되었으며(청구됨) 모니터링이 활성화되었습니다. already_enabled: type: integer description: 모니터링이 이미 활성화되어 있었으며, 변경된 사항이 없고 청구되지 않았습니다. disabled: type: integer description: 프로필의 모든 AML 스크리닝에서 모니터링이 꺼졌습니다. skipped_no_identity_data: type: integer description: '건너뜀: 프로필에 스크리닝에 필요한 성명, 생년월일, 국가(사용자) 또는 이름(기업)이 없습니다.' skipped_blocked: type: integer description: '건너뜀: 사용자가 차단되었습니다.' skipped_sandbox: type: integer description: '건너뜀: 샌드박스 애플리케이션으로 스크리닝이 생성되지 않습니다.' failed_provider: type: integer description: 스크리닝을 완료할 수 없습니다. 나중에 다시 시도하세요. failed_insufficient_balance: type: integer description: 작업이 실행되는 동안 잔액이 소진되었습니다. results: type: array description: >- 처리 순서에 따른 처리된 프로필당 항목 1개입니다. 작업이 실행되는 동안 증가하며 상태가 COMPLETED가 되면 완료됩니다. API를 통해 시작된 작업에 대해 기록되며, Business Console에서 시작된 작업은 카운터만 보고합니다. items: type: object properties: didit_internal_id: type: string format: uuid description: 프로필의 Didit 내부 ID입니다. vendor_data: type: string nullable: true description: 프로필에 대한 귀하 고유의 식별자입니다. outcome: type: string enum: - enabled - screened_and_enabled - already_enabled - disabled - skipped_no_identity_data - skipped_blocked - skipped_sandbox - failed_provider - failed_insufficient_balance error: type: string nullable: true description: 상태가 FAILED일 때의 일반 실패 메시지입니다. 자세한 원인은 플랫폼 측에 보관됩니다. created_at: type: string format: date-time completed_at: type: string format: date-time nullable: true '401': description: API 키가 누락되었거나 유효하지 않습니다. '404': description: 이 애플리케이션에 해당 작업이 없습니다. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl 'https://verification.didit.me/v3/aml-monitoring/jobs/JOB_ID/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.aml_monitoring.retrieve_job( "11111111-2222-3333-4444-555555555555", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.amlMonitoring.retrieveJob("11111111-2222-3333-4444-555555555555"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.AMLMonitoring.RetrieveJob(ctx, \"11111111-2222-3333-4444-555555555555\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.amlMonitoring().retrieveJob("11111111-2222-3333-4444-555555555555"); System.out.println(result); - lang: php label: PHP source: >- amlMonitoring->retrieveJob('11111111-2222-3333-4444-555555555555'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.aml_monitoring.retrieve_job("11111111-2222-3333-4444-555555555555") puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.AmlMonitoring.RetrieveJobAsync("11111111-2222-3333-4444-555555555555"); Console.WriteLine(JsonSerializer.Serialize(result)); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.