> ## 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. # Monitoratge AML continu: obtenir tasca API > Consulta amb Didit l'estat, els comptadors i els resultats per registre d'una tasca de monitoratge AML continu iniciada des d'usuaris o empreses. Prompt per obtenir la tasca de monitoratge AML Copia el prompt al porta-retalls \

\`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.`

\
Enganxa a ## Visió generalRetorna una tasca de monitoratge AML continu iniciada des de [Alternar el monitoratge AML per a usuaris](https://docs.didit.me/ca/management-api/aml-monitoring/toggle-users.md) o [Alternar el monitoratge AML per a empreses](https://docs.didit.me/ca/management-api/aml-monitoring/toggle-businesses.md): el seu estat, els comptadors per resultat i una entrada de `results` per cada usuari o empresa processat.Les seleccions de més de 20 perfils s'executen en segon pla, i la sol·licitud d'alternança retorna `202` amb una tasca `PENDING`. Consulta aquest endpoint cada dos segons aproximadament fins que `status` sigui `COMPLETED` o `FAILED`. `results` s'omple a mesura que es processen els perfils, en l'ordre de processament, i és complet quan la tasca està `COMPLETED`. Els resultats per registre es guarden per a les tasques iniciades a través de l'API; una tasca iniciada des de la Business Console només informa dels comptadors.## Estat de la tasca| `status` | Significat | | - | - | | `PENDING` | Acceptada, encara no iniciada. | | `PROCESSING` | En execució; `processed`, `outcomes` i `results` s'estan actualitzant. | | `COMPLETED` | Cada perfil té un resultat. | | `FAILED` | La tasca s'ha aturat abans d'hora. `error` conté un missatge genèric i breu, i es conserven els resultats registrats abans de la fallada. Torna a enviar la sol·licitud d'alternança per als perfils que encara no tenen resultat. |Els valors de `outcome` per registre es documenten a les pàgines d'alternança.## PermisosQualsevol clau d'API activa de l'aplicació pot cridar aquest endpoint. Una tasca només és visible per a l'aplicació que l'ha creada; qualsevol altre `job_id` retorna `404`.## Relacionats- [Alternar el monitoratge AML per a usuaris](https://docs.didit.me/ca/management-api/aml-monitoring/toggle-users.md) - [Alternar el monitoratge AML per a empreses](https://docs.didit.me/ca/management-api/aml-monitoring/toggle-businesses.md) - [Monitoratge AML continu](https://docs.didit.me/ca/core-technology/aml-screening/continuous-monitoring-aml-screening.md) ## OpenAPI ````yaml ca/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 de verificació d'identitat. Autentica't amb la capçalera x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/aml-monitoring/jobs/{job_id}/: get: tags: - AML Ongoing Monitoring summary: Obtenir la tasca de monitoratge AML continu description: >- Estat, comptadors de resultats i resultats per registre d'una tasca d'activació o desactivació de monitoratge iniciada des de `POST /v3/users/aml-monitoring/` o `POST /v3/businesses/aml-monitoring/`. Fes sondeig cada dos segons mentre `status` sigui `PENDING` o `PROCESSING`; `results` està complet un cop sigui `COMPLETED`. operationId: get_aml_monitoring_job parameters: - name: job_id in: path required: true schema: type: string format: uuid description: El `job_id` retornat per l'endpoint d'activació/desactivació. responses: '200': description: La tasca. 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 quan la tasca activa el monitoratge, false quan el desactiva. target_type: type: string enum: - user - business description: Quina família de perfils commuta la tasca. total: type: integer description: Perfils que processa la tasca. processed: type: integer description: Perfils processats fins ara. outcomes: type: object description: >- Comptadors de resultats per registre. Cada perfil seleccionat s'assigna exactament a un comptador; no s'omet res silenciosament. properties: enabled: type: integer description: Monitoratge activat en un cribratge AML existent. screened_and_enabled: type: integer description: >- S'ha creat un nou cribratge AML (facturat) i s'hi ha activat el monitoratge. already_enabled: type: integer description: >- El monitoratge ja estava actiu; no s'ha modificat res ni s'ha facturat res. disabled: type: integer description: >- Monitoratge desactivat a tots els cribratges AML del perfil. skipped_no_identity_data: type: integer description: >- Omès: el perfil no disposa del nom complet, la data de naixement i el país (usuaris) o del nom (empreses) necessaris per cribrar. skipped_blocked: type: integer description: 'Omès: l''usuari està bloquejat.' skipped_sandbox: type: integer description: 'Omès: aplicació de sandbox, no es crea cap cribratge.' failed_provider: type: integer description: >- No s'ha pogut completar el cribratge; reintenta-ho més tard. failed_insufficient_balance: type: integer description: El saldo s'ha esgotat mentre s'executava la tasca. results: type: array description: >- Una entrada per perfil processat, en ordre de processament. Creix mentre s'executa la tasca; es completa un cop l'estat és COMPLETED. Es registra per a les tasques iniciades mitjançant l'API; una tasca iniciada des de la Business Console només reporta comptadors. items: type: object properties: didit_internal_id: type: string format: uuid description: ID intern de Didit del perfil. vendor_data: type: string nullable: true description: El teu propi identificador per al perfil. 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: >- Missatge d'error genèric quan l'estat és FAILED; la causa detallada es manté a la plataforma. created_at: type: string format: date-time completed_at: type: string format: date-time nullable: true '401': description: Falta la clau d'API o no és vàlida. '404': description: No existeix aquesta tasca per a aquesta aplicació. 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: >- La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.