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

# Ambil Job Pemantauan AML Berkelanjutan API

> Cek status, penghitung hasil, dan hasil per catatan job Pemantauan AML Berkelanjutan di Didit yang dimulai dari endpoint pengguna atau bisnis.



Prompt Mendapatkan Job Pemantauan AML
        Salin prompt ke papan klip



      
      

\<pre>

\`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: <DIDIT_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": "<uuid>",
"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": "<uuid>", "vendor_data": "user-123", "outcome": "enabled"},
...one entry per processed profile, in processing order...
],
"error": null,                     // generic message when status is FAILED
"created_at": "<datetime>",
"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.`

\</pre>



      
      

Tempel ke

## IkhtisarMengembalikan job pemantauan AML berkelanjutan yang dimulai dari [Aktifkan/Nonaktifkan Pemantauan AML untuk Pengguna](https://docs.didit.me/id/management-api/aml-monitoring/toggle-users.md) atau [Aktifkan/Nonaktifkan Pemantauan AML untuk Bisnis](https://docs.didit.me/id/management-api/aml-monitoring/toggle-businesses.md): statusnya, penghitung per hasil, dan satu entri `results` untuk setiap pengguna atau bisnis yang diproses.Pilihan lebih dari 20 profil dijalankan di latar belakang dan panggilan untuk mengaktifkan atau menonaktifkan pemantauan mengembalikan `202` dengan job `PENDING`. Lakukan polling ke endpoint ini setiap beberapa detik hingga `status` bernilai `COMPLETED` atau `FAILED`. `results` terisi seiring profil diproses, sesuai urutan pemrosesan, dan sudah lengkap saat job bernilai `COMPLETED`. Hasil per rekaman dicatat untuk job yang dimulai melalui API; job yang dimulai dari Business Console hanya melaporkan penghitung.## Status job| `status` | Arti |
| - | - |
| `PENDING` | Diterima, belum dimulai. |
| `PROCESSING` | Sedang berjalan; `processed`, `outcomes`, dan `results` sedang diperbarui. |
| `COMPLETED` | Setiap profil sudah memiliki hasil. |
| `FAILED` | Job berhenti lebih awal. `error` berisi pesan singkat yang umum, dan hasil yang tercatat sebelum kegagalan tetap disimpan. Kirim ulang permintaan untuk mengaktifkan atau menonaktifkan pemantauan bagi profil yang belum memiliki hasil. |Nilai `outcome` per rekaman didokumentasikan di halaman untuk mengaktifkan atau menonaktifkan pemantauan.## IzinSetiap kunci API yang aktif dari aplikasi dapat memanggil endpoint ini. Job hanya dapat dilihat oleh aplikasi yang membuatnya; `job_id` lain mengembalikan `404`.## Terkait- [Aktifkan/Nonaktifkan Pemantauan AML untuk Pengguna](https://docs.didit.me/id/management-api/aml-monitoring/toggle-users.md)
- [Aktifkan/Nonaktifkan Pemantauan AML untuk Bisnis](https://docs.didit.me/id/management-api/aml-monitoring/toggle-businesses.md)
- [Pemantauan AML Berkelanjutan](https://docs.didit.me/id/core-technology/aml-screening/continuous-monitoring-aml-screening.md)


## OpenAPI

````yaml id/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 Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/aml-monitoring/jobs/{job_id}/:
    get:
      tags:
        - AML Ongoing Monitoring
      summary: Dapatkan tugas pemantauan AML berkelanjutan
      description: >-
        Status, penghitung hasil, dan hasil untuk setiap catatan dari tugas
        pengaktifan atau penonaktifan pemantauan yang dimulai dari `POST
        /v3/users/aml-monitoring/` atau `POST /v3/businesses/aml-monitoring/`.
        Lakukan polling setiap beberapa detik saat `status` bernilai `PENDING`
        atau `PROCESSING`; `results` selesai setelah bernilai `COMPLETED`.
      operationId: get_aml_monitoring_job
      parameters:
        - name: job_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: '`job_id` yang dikembalikan oleh endpoint untuk mengubah status.'
      responses:
        '200':
          description: Pekerjaan tersebut.
          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 saat pekerjaan mengaktifkan pemantauan, false saat
                      menonaktifkannya.
                  target_type:
                    type: string
                    enum:
                      - user
                      - business
                    description: >-
                      Famili profil mana yang diaktif-nonaktifkan oleh tugas
                      ini.
                  total:
                    type: integer
                    description: Profil yang diproses oleh tugas.
                  processed:
                    type: integer
                    description: Profil yang diproses sejauh ini.
                  outcomes:
                    type: object
                    description: >-
                      Penghitung hasil per rekaman. Setiap profil yang dipilih
                      dipetakan ke tepat satu penghitung; tidak ada yang
                      dilewati secara diam-diam.
                    properties:
                      enabled:
                        type: integer
                        description: Pemantauan diaktifkan pada skrining AML yang ada.
                      screened_and_enabled:
                        type: integer
                        description: >-
                          Skrining AML baru telah dibuat (ditagihkan) dan
                          pemantauan diaktifkan untuk skrining tersebut.
                      already_enabled:
                        type: integer
                        description: >-
                          Pemantauan sudah aktif sebelumnya; tidak ada yang
                          berubah dan tidak ada yang ditagihkan.
                      disabled:
                        type: integer
                        description: Pemantauan dinonaktifkan di semua skrining AML profil.
                      skipped_no_identity_data:
                        type: integer
                        description: >-
                          Dilewati: profil tidak memiliki nama lengkap, tanggal
                          lahir, dan negara (pengguna) atau nama (bisnis) yang
                          diperlukan untuk diskrining.
                      skipped_blocked:
                        type: integer
                        description: 'Dilewati: pengguna diblokir.'
                      skipped_sandbox:
                        type: integer
                        description: >-
                          Dilewati: aplikasi sandbox, tidak ada skrining yang
                          dibuat.
                      failed_provider:
                        type: integer
                        description: Skrining tidak dapat diselesaikan; coba lagi nanti.
                      failed_insufficient_balance:
                        type: integer
                        description: Saldo habis saat pekerjaan sedang berjalan.
                  results:
                    type: array
                    description: >-
                      Satu entri per profil yang diproses, sesuai urutan
                      pemrosesan. Bertambah saat tugas berjalan; lengkap setelah
                      statusnya COMPLETED. Dicatat untuk tugas yang dimulai
                      melalui API; tugas yang dimulai dari Business Console
                      hanya melaporkan jumlah.
                    items:
                      type: object
                      properties:
                        didit_internal_id:
                          type: string
                          format: uuid
                          description: ID internal Didit untuk profil tersebut.
                        vendor_data:
                          type: string
                          nullable: true
                          description: Pengenal Anda sendiri untuk profil tersebut.
                        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: >-
                      Pesan kegagalan umum saat status FAILED; penyebab
                      terperinci disimpan di sisi platform.
                  created_at:
                    type: string
                    format: date-time
                  completed_at:
                    type: string
                    format: date-time
                    nullable: true
        '401':
          description: Kunci API tidak ada atau tidak valid.
        '404':
          description: Tidak ada job seperti itu untuk aplikasi ini.
      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: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $result =
            $didit->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: >-
        Kunci API aplikasi Anda, dari Developers -> API keys di Business
        Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi
        cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa
        alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan
        pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau
        kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak
        memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang
        dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi
        berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses
        media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa
        izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat
        https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.