> ## 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-Überwachung für Unternehmen umschalten (Didit API) > Schalten Sie die laufende AML-Überwachung für viele Unternehmen per Aufruf ein oder aus – mit Kostenschätzung, abfragbarem Job und Ergebnis je Unternehmen. Prompt zum Umschalten der AML-Überwachung für Unternehmen Prompt in die Zwischenablage kopieren \

\`Goal: Enable or disable ongoing AML monitoring for one or many Didit Business (KYB) entities in a single call, with the same semantics as the Business Console. Preview the cost first with estimate_only, then run the change and read the per-business outcome.

Endpoint: POST https://verification.didit.me/v3/businesses/aml-monitoring/
Auth header: x-api-key: 
Content-Type: application/json

Request body:
\- is_enabled: boolean (required) - true to enable monitoring, false to disable it.
\- estimate_only: boolean (default false) - when true, returns the cost preview and performs NO writes: no screening, no billing, no job.
\- vendor_data_list: string[] - your own identifiers, matched exactly as sent.
\- didit_internal_id_list: string[] (UUIDs) - the didit_internal_id returned by the create, get and list endpoints.
Provide at least one list; the two are OR'd. At most 1000 identifiers per request across both lists - split larger selections into several calls.

Semantics:
\- One monitored screening per business: a company that verified several times is monitored and billed once. Disabling turns monitoring off across all of the business's screenings.
\- Businesses without any AML screening are screened first (billed as a regular AML screening) using their legal name (or display name) and country; a business with no name is reported as skipped_no_identity_data.
\- Sandbox applications never create screenings (skipped_sandbox).
\- Enabling is refused with 403 when the organization balance does not cover the estimate; the response carries the estimate.

curl (estimate first):
curl -X POST 'https://verification.didit.me/v3/businesses/aml-monitoring/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"is_enabled": true, "estimate_only": true, "vendor_data_list": ["company-123", "company-456"]}'

Response 200 (estimate_only):
\{
"users_total": 2, "already_enabled": 0, "with_existing_aml": 1, "needing_screening": 1,
"skipped_no_identity_data": 0, "skipped_blocked": 0,
"estimated_screening_cost_usd": 0.2, "estimated_annual_monitoring_cost_usd": 0.14,
"balance_sufficient": true, "unmatched": []
}
(users_total counts the selected businesses; the estimate shape is shared with the users endpoint.)

curl (enable):
curl -X POST 'https://verification.didit.me/v3/businesses/aml-monitoring/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"is_enabled": true, "vendor_data_list": ["company-123", "company-456"]}'

Response 200 (20 businesses or fewer - processed inline, already COMPLETED) or 202 (more than 20 - running in the background):
\{
"job_id": "", "status": "COMPLETED", "is_enabled": true, "target_type": "business",
"total": 2, "processed": 2,
"outcomes": {"enabled": 1, "screened_and_enabled": 1, "already_enabled": 0, "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": "company-123", "outcome": "enabled"},
\{"didit_internal_id": "", "vendor_data": "company-456", "outcome": "screened_and_enabled"}
],
"estimate": { ...same shape as above, without unmatched... },
"unmatched": [],
"error": null,                     // generic message when status is FAILED
"created_at": "", "completed_at": ""
}
On 202, poll GET /v3/aml-monitoring/jobs/{job_id}/ every couple of seconds until status is COMPLETED or FAILED; results fills in as businesses are processed.

Per-business outcome values: enabled, screened_and_enabled, already_enabled, disabled, skipped_no_identity_data, skipped_sandbox, failed_provider, failed_insufficient_balance (skipped_blocked is always 0 for businesses).

Failure modes:
\- 400 - is_enabled missing, no selector, or more than 1000 identifiers across both lists.
A selection that matches nothing is NOT an error: the job completes with total 0 and every identifier is listed under unmatched (same convention as the batch delete endpoints).
\- 401 - missing/invalid x-api-key.
\- 403 - insufficient balance to enable monitoring for this selection (body: error + estimate).

Idempotency: re-sending an enable returns already_enabled for businesses that are already monitored, with no second screening and no second bill. Disabling an unmonitored business returns disabled and changes nothing.

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

\
Einfügen in ## ÜberblickAktiviert oder deaktiviert die [laufende AML-Überwachung](https://docs.didit.me/de/core-technology/aml-screening/continuous-monitoring-aml-screening.md) für die ausgewählten [Unternehmen](https://docs.didit.me/de/entities/businesses/overview.md), genau wie die Aktion **Laufende AML-Überwachung** in der Business Console. Die Console und dieser Endpoint führen denselben zugrunde liegenden Vorgang aus, daher sind die Regeln, die Abrechnung und die Ergebnisse identisch.Senden Sie zuerst `estimate_only: true`, um zu sehen, wie viele Unternehmen ausgewählt sind, wie viele ein neues AML-Screening benötigen, die einmalige Screening-Gebühr und die jährlichen Überwachungskosten. Ein Testlauf (Dry-Run) schreibt nichts. Die Schätzung verwendet dieselben Feldnamen wie der Users-Endpoint, daher ist `users_total` die Anzahl der ausgewählten Unternehmen.## So wird eine Auswahl verarbeitet- **Ein überwachtes Screening pro Unternehmen.** Ein Unternehmen, das sich mehrfach verifiziert hat, wird nur einmal überwacht und einmal abgerechnet. Die Deaktivierung schaltet die Überwachung für alle Screenings dieses Unternehmens ab. - **Unternehmen ohne AML-Screening werden zuerst gescreent.** Didit erstellt für sie eine neue AML-Verifizierung (sichtbar im Tab **Verifizierungen** des Unternehmens), die wie ein reguläres AML-Screening abgerechnet wird, und aktiviert darauf die Überwachung. Das Screening verwendet den rechtlichen Namen (oder den Anzeigenamen) und das Land des Unternehmens. Ein Unternehmen ganz ohne Namen wird als `skipped_no_identity_data` gemeldet und nicht stillschweigend verworfen. - **Sandbox-Anwendungen erstellen nie Screenings** (`skipped_sandbox`). - **Das Guthaben wird vorab geprüft.** Die Aktivierung wird mit `403` abgelehnt, wenn Ihr Guthaben die Schätzung nicht deckt. Die Antwort enthält die Schätzung, damit Sie wissen, wie viel Sie aufladen müssen. - **Jährliche Verlängerung.** Ein neu überwachtes Unternehmen wird zum Preis für die jährliche Überwachung am nächsten Verlängerungsdatum abgerechnet, also zu dem Datum, das die Console in der Spalte **Laufende Überwachung** anzeigt. Die Deaktivierung stoppt die Verlängerung, erstattet aber keinen bereits abgerechneten Zeitraum.## Auswahl und Batch-GrößeWählen Sie Unternehmen über `vendor_data_list`, `didit_internal_id_list` oder beide aus. Die beiden Listen werden mit ODER verknüpft. Eine Anfrage akzeptiert insgesamt höchstens **1000 Identifikatoren** über beide Listen. Identifikatoren, die keinem Unternehmen in Ihrer Anwendung entsprechen, werden unverändert unter `unmatched` zurückgegeben und lassen die Anfrage nie fehlschlagen. Eine Auswahl ohne Treffer wird als leerer Job abgeschlossen (`total: 0`), wobei alle Identifikatoren aufgelistet werden, wie bei den Batch-Lösch-Endpoints.## Inline oder im HintergrundAuswahlen mit **höchstens 20 Unternehmen** werden inline verarbeitet, und der Aufruf gibt `200` mit dem abgeschlossenen Job zurück. Größere Auswahlen geben `202` mit einem Job im Status `PENDING` zurück. Fragen Sie [AML-Monitoring-Job abrufen](https://docs.didit.me/de/management-api/aml-monitoring/get-job.md) ab, bis `status` `COMPLETED` oder `FAILED` ist. In beiden Fällen enthält der Job pro Unternehmen einen Eintrag in `results` mit dessen `outcome`.| `outcome` | Bedeutung | | - | - | | `enabled` | Überwachung wurde für ein bestehendes AML-Screening aktiviert. | | `screened_and_enabled` | Ein neues AML-Screening wurde erstellt (abgerechnet) und die Überwachung darauf aktiviert. | | `already_enabled` | Die Überwachung war bereits aktiv. Nichts wurde geändert und nichts abgerechnet. | | `disabled` | Die Überwachung wurde für alle Screenings des Unternehmens deaktiviert. | | `skipped_no_identity_data` | Das Unternehmen hat keinen rechtlichen Namen oder Anzeigenamen, der gescreent werden könnte. | | `skipped_sandbox` | Sandbox-Anwendung. Es wird kein Screening erstellt. | | `failed_provider` | Das Screening konnte nicht abgeschlossen werden. Versuchen Sie es später erneut. | | `failed_insufficient_balance` | Das Guthaben ist während der Ausführung des Jobs aufgebraucht. |## WebhooksDas Umschalten der Überwachung sendet keinen eigenen Webhook. Sobald die Überwachung aktiv ist, lösen erneute Screenings weiterhin die üblichen Ereignisse `status.updated` und `data.updated` aus, die unter [Laufende AML-Überwachung](https://docs.didit.me/de/core-technology/aml-screening/continuous-monitoring-aml-screening.md) beschrieben sind.## BerechtigungenJeder aktive API-Schlüssel der Anwendung kann diesen Endpoint aufrufen. Didit-API-Schlüssel sind **anwendungsbezogen, nicht rollenbezogen**. Die [Rollen und Berechtigungen](https://docs.didit.me/de/console/roles-permissions.md) der Console legen fest, was eine *Person* in der Console tun darf, und werden für Datenverkehr der Management API nicht ausgewertet.## Verwandte Themen- [AML-Monitoring-Job abrufen](https://docs.didit.me/de/management-api/aml-monitoring/get-job.md) - [AML-Überwachung für Benutzer umschalten](https://docs.didit.me/de/management-api/aml-monitoring/toggle-users.md) - [Laufende AML-Überwachung](https://docs.didit.me/de/core-technology/aml-screening/continuous-monitoring-aml-screening.md) - [AML-Screening für Unternehmen](https://docs.didit.me/de/business-verification/aml.md) - [Unternehmen auflisten](https://docs.didit.me/de/management-api/businesses/list.md) ## OpenAPI ````yaml de/openapi-25.json POST /v3/businesses/aml-monitoring/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/businesses/aml-monitoring/: post: tags: - AML Ongoing Monitoring summary: Laufende AML-Überwachung für Unternehmen aktivieren oder deaktivieren description: >- Schaltet die laufende AML-Überwachung für die ausgewählten Unternehmen ein oder aus, mit derselben Semantik wie die Business Console. Pro Unternehmen wird genau ein überwachtes AML-Screening beibehalten, sodass ein Profil, das sich mehrmals verifiziert hat, einmal überwacht und abgerechnet wird; das Deaktivieren schaltet die Überwachung für alle Screenings des Profils ab. Unternehmen ohne jegliches AML-Screening werden zuerst gescreent (abgerechnet als reguläres AML-Screening), wenn sie den erforderlichen rechtlichen Namen oder Anzeigenamen haben; andernfalls werden sie als `skipped_no_identity_data` gemeldet. Setzen Sie `estimate_only: true`, um eine Vorschau der Anzahlen und Kosten anzuzeigen, ohne Änderungen zu schreiben. Auswahlen von 20 oder weniger Profilen werden direkt aufgelöst und geben `200` mit dem abgeschlossenen Job zurück; größere Auswahlen geben `202` zurück und laufen im Hintergrund – fragen Sie [AML-Überwachungsjob abrufen](#get-/v3/aml-monitoring/jobs/-job_id-/) mit der zurückgegebenen `job_id` ab. Die Aktivierung wird mit `403` abgelehnt, wenn das Guthaben der Organisation die Schätzung nicht deckt. Bezeichner, die mit nichts übereinstimmen, werden in `unmatched` aufgeführt und führen nie zum Fehlschlagen der Anfrage: Eine Auswahl, die mit nichts übereinstimmt, wird als leerer Job (`total` 0) abgeschlossen – dieselbe Konvention wie bei den Batch-Lösch-Endpoints. operationId: toggle_businesses_aml_monitoring requestBody: required: true content: application/json: schema: type: object required: - is_enabled description: >- Wählen Sie Unternehmen mit `vendor_data_list`, `didit_internal_id_list` oder beiden aus (die beiden Listen werden ODER-verknüpft). Maximal 1000 IDs pro Anfrage über beide Listen hinweg. properties: is_enabled: type: boolean description: >- true, um die Überwachung zu aktivieren, false, um sie zu deaktivieren. estimate_only: type: boolean default: false description: >- Wenn true, wird die Kostenschätzung zurückgegeben und es werden keine Schreibvorgänge ausgeführt – kein Screening, keine Abrechnung, kein Job. vendor_data_list: type: array items: type: string description: >- Ihre eigenen Kennungen der umzuschaltenden Unternehmen, exakt so abgeglichen wie übermittelt. didit_internal_id_list: type: array items: type: string format: uuid description: >- Interne Didit-IDs der umzuschaltenden Unternehmen – die von den Create-, Get- und List-Endpoints zurückgegebene `didit_internal_id`. examples: Estimate first: summary: Vorschau der Kosten ohne Schreibvorgang anzeigen value: is_enabled: true estimate_only: true vendor_data_list: - company-123 - company-456 Enable: summary: Überwachung für zwei Unternehmen aktivieren value: is_enabled: true vendor_data_list: - company-123 - company-456 Disable: summary: Überwachung anhand der internen Didit-ID deaktivieren value: is_enabled: false didit_internal_id_list: - 3f1c0d3e-8f0a-4c2e-9a3d-9b1f5f4a2c11 responses: '200': description: >- Die Schätzung (wenn `estimate_only` true ist) oder der abgeschlossene Job für eine inline verarbeitete Auswahl. content: application/json: schema: $ref: '#/components/schemas/AMLMonitoringToggleResult' '202': description: >- Größere Auswahlen werden im Hintergrund ausgeführt. Fragen Sie den Job-Endpoint mit `job_id` ab; `results` wird befüllt, sobald die Profile verarbeitet sind. content: application/json: schema: $ref: '#/components/schemas/AMLMonitoringJob' '400': description: >- Validierungsfehler: `is_enabled` fehlt, kein Selektor oder mehr als 1000 Bezeichner über beide Listen hinweg. '401': description: Fehlender oder ungültiger API-Schlüssel. '403': description: >- Unzureichendes Guthaben, um die Überwachung für diese Auswahl zu aktivieren. Die Antwort enthält die Schätzung (`estimate`), damit Sie den richtigen Betrag aufladen können. content: application/json: schema: type: object properties: error: type: string estimate: type: object description: >- Kostenvorschau. Wird direkt zurückgegeben, wenn estimate_only wahr ist (es wird nichts geschrieben). properties: users_total: type: integer description: Profile, die der Auswahl entsprechen. already_enabled: type: integer description: >- Profile, die bereits überwacht werden (beim Aktivieren ist nichts zu tun; diese werden beim Deaktivieren abgeschaltet). with_existing_aml: type: integer description: >- Profile, deren bestehendes AML-Screening auf überwacht umgestellt wird (kein neues Screening). needing_screening: type: integer description: >- Profile ohne bisheriges AML-Screening, die zuerst gescreent werden (abgerechnet als reguläres AML-Screening). skipped_no_identity_data: type: integer description: >- Profile, die nicht gescreent werden können, da Identitätsdaten fehlen. skipped_blocked: type: integer description: >- Gesperrte Benutzer, die übersprungen werden (bei Unternehmen immer 0). estimated_screening_cost_usd: type: number example: 0.2 description: Einmalige Kosten für die neuen Screenings. estimated_annual_monitoring_cost_usd: type: number example: 0.07 description: >- Jährliche Überwachungskosten für die Profile, die künftig überwacht werden. balance_sufficient: type: boolean description: >- Gibt an, ob das Guthaben der Organisation das Screening plus das erste Jahr der Überwachung abdeckt. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST 'https://verification.didit.me/v3/businesses/aml-monitoring/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"is_enabled": true, "vendor_data_list": ["company-123", "company-456"]}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.businesses.set_aml_monitoring( is_enabled=True, estimate_only=True, vendor_data_list=["company-123", "company-456"], ) 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.businesses.setAmlMonitoring({ is_enabled: true, estimate_only: true, vendor_data_list: ["company-123", "company-456"], }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Businesses.SetAMLMonitoring(ctx, didit.BusinessesSetAMLMonitoringParams{\n\tIsEnabled: true,\n\tEstimateOnly: didit.Bool(true),\n\tVendorDataList: didit.Some([]string{\"company-123\", \"company-456\"}),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import java.util.List; import me.didit.Didit; import me.didit.types.BusinessesSetAmlMonitoringParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.businesses().setAmlMonitoring(BusinessesSetAmlMonitoringParams.builder() .isEnabled(true) .estimateOnly(true) .vendorDataList(List.of("company-123", "company-456")) .build()); System.out.println(result); - lang: php label: PHP source: |- businesses->setAmlMonitoring([ 'is_enabled' => true, 'estimate_only' => true, 'vendor_data_list' => ['company-123', 'company-456'], ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.businesses.set_aml_monitoring( is_enabled: true, estimate_only: true, vendor_data_list: ["company-123", "company-456"] ) 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.Businesses.SetAmlMonitoringAsync(new BusinessesSetAmlMonitoringParams { IsEnabled = true, EstimateOnly = true, VendorDataList = new string[] { "company-123", "company-456" }, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: AMLMonitoringToggleResult: oneOf: - type: object required: - users_total - already_enabled - with_existing_aml - needing_screening - skipped_no_identity_data - skipped_blocked - estimated_screening_cost_usd - estimated_annual_monitoring_cost_usd - balance_sufficient - unmatched description: >- Kostenvorschau. Wird direkt zurückgegeben, wenn estimate_only wahr ist (es wird nichts geschrieben). properties: users_total: type: integer description: Profile, die der Auswahl entsprechen. already_enabled: type: integer description: >- Profile, die bereits überwacht werden (beim Aktivieren ist nichts zu tun; diese werden beim Deaktivieren abgeschaltet). with_existing_aml: type: integer description: >- Profile, deren bestehendes AML-Screening auf überwacht umgestellt wird (kein neues Screening). needing_screening: type: integer description: >- Profile ohne bisheriges AML-Screening, die zuerst gescreent werden (abgerechnet als reguläres AML-Screening). skipped_no_identity_data: type: integer description: >- Profile, die nicht gescreent werden können, da Identitätsdaten fehlen. skipped_blocked: type: integer description: >- Gesperrte Benutzer, die übersprungen werden (bei Unternehmen immer 0). estimated_screening_cost_usd: type: number example: 0.2 description: Einmalige Kosten für die neuen Screenings. estimated_annual_monitoring_cost_usd: type: number example: 0.07 description: >- Jährliche Überwachungskosten für die Profile, die künftig überwacht werden. balance_sufficient: type: boolean description: >- Gibt an, ob das Guthaben der Organisation das Screening plus das erste Jahr der Überwachung abdeckt. unmatched: type: array items: type: string description: >- Kennungen der Anfrage, die mit keinem Profil in dieser Anwendung übereinstimmten, exakt wie gesendet. - type: object required: - job_id - status - is_enabled - target_type - total - processed - outcomes - results - error - created_at - completed_at - estimate - unmatched properties: job_id: type: string format: uuid status: type: string enum: - PENDING - PROCESSING - COMPLETED - FAILED is_enabled: type: boolean description: >- true, wenn der Job die Überwachung aktiviert, false, wenn er sie deaktiviert. target_type: type: string enum: - user - business description: Welche Profilfamilie der Auftrag umschaltet. total: type: integer description: Profile, die der Job verarbeitet. processed: type: integer description: Bisher verarbeitete Profile. outcomes: type: object description: >- Ergebniszähler pro Datensatz. Jedes ausgewählte Profil wird genau einem Zähler zugeordnet; nichts wird stillschweigend übersprungen. properties: enabled: type: integer description: Überwachung für ein bestehendes AML-Screening aktiviert. screened_and_enabled: type: integer description: >- Ein neues AML-Screening wurde erstellt (in Rechnung gestellt) und die Überwachung dafür aktiviert. already_enabled: type: integer description: >- Überwachung war bereits aktiv; es wurde nichts geändert und nichts in Rechnung gestellt. disabled: type: integer description: Überwachung für jedes AML-Screening des Profils deaktiviert. skipped_no_identity_data: type: integer description: >- Übersprungen: Dem Profil fehlen der vollständige Name, das Geburtsdatum und das Land (Benutzer) oder ein Name (Unternehmen), die für das Screening erforderlich sind. skipped_blocked: type: integer description: 'Übersprungen: Der Benutzer ist gesperrt.' skipped_sandbox: type: integer description: >- Übersprungen: Sandbox-Anwendung, es wird kein Screening erstellt. failed_provider: type: integer description: >- Das Screening konnte nicht abgeschlossen werden; versuchen Sie es später erneut. failed_insufficient_balance: type: integer description: Das Guthaben wurde aufgebraucht, während der Auftrag lief. results: type: array description: >- Ein Eintrag pro verarbeitetem Profil, in der Reihenfolge der Verarbeitung. Wächst, während der Job läuft; vollständig, sobald der Status COMPLETED ist. Erfasst für Jobs, die über die API gestartet wurden. items: type: object properties: didit_internal_id: type: string format: uuid description: Interne Didit-ID des Profils. vendor_data: type: string nullable: true description: Ihre eigene Kennung für das Profil. 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: >- Generische Fehlermeldung, wenn der Status FAILED lautet; die detaillierte Ursache verbleibt auf Plattformseite. created_at: type: string format: date-time completed_at: type: string format: date-time nullable: true estimate: type: object description: >- Kostenvorschau. Wird direkt zurückgegeben, wenn estimate_only wahr ist (es wird nichts geschrieben). properties: users_total: type: integer description: Profile, die der Auswahl entsprechen. already_enabled: type: integer description: >- Profile, die bereits überwacht werden (beim Aktivieren ist nichts zu tun; diese werden beim Deaktivieren abgeschaltet). with_existing_aml: type: integer description: >- Profile, deren bestehendes AML-Screening auf überwacht umgestellt wird (kein neues Screening). needing_screening: type: integer description: >- Profile ohne bisheriges AML-Screening, die zuerst gescreent werden (abgerechnet als reguläres AML-Screening). skipped_no_identity_data: type: integer description: >- Profile, die nicht gescreent werden können, da Identitätsdaten fehlen. skipped_blocked: type: integer description: >- Gesperrte Benutzer, die übersprungen werden (bei Unternehmen immer 0). estimated_screening_cost_usd: type: number example: 0.2 description: Einmalige Kosten für die neuen Screenings. estimated_annual_monitoring_cost_usd: type: number example: 0.07 description: >- Jährliche Überwachungskosten für die Profile, die künftig überwacht werden. balance_sufficient: type: boolean description: >- Gibt an, ob das Guthaben der Organisation das Screening plus das erste Jahr der Überwachung abdeckt. unmatched: type: array items: type: string description: >- Kennungen der Anfrage, die mit keinem Profil in dieser Anwendung übereinstimmten, exakt wie gesendet. Sie sind nicht Teil des Auftrags. AMLMonitoringJob: type: object properties: job_id: type: string format: uuid status: type: string enum: - PENDING - PROCESSING - COMPLETED - FAILED is_enabled: type: boolean description: >- true, wenn der Job die Überwachung aktiviert, false, wenn er sie deaktiviert. target_type: type: string enum: - user - business description: Welche Profilfamilie der Auftrag umschaltet. total: type: integer description: Profile, die der Job verarbeitet. processed: type: integer description: Bisher verarbeitete Profile. outcomes: type: object description: >- Ergebniszähler pro Datensatz. Jedes ausgewählte Profil wird genau einem Zähler zugeordnet; nichts wird stillschweigend übersprungen. properties: enabled: type: integer description: Überwachung für ein bestehendes AML-Screening aktiviert. screened_and_enabled: type: integer description: >- Ein neues AML-Screening wurde erstellt (in Rechnung gestellt) und die Überwachung dafür aktiviert. already_enabled: type: integer description: >- Überwachung war bereits aktiv; es wurde nichts geändert und nichts in Rechnung gestellt. disabled: type: integer description: Überwachung für jedes AML-Screening des Profils deaktiviert. skipped_no_identity_data: type: integer description: >- Übersprungen: Dem Profil fehlen der vollständige Name, das Geburtsdatum und das Land (Benutzer) oder ein Name (Unternehmen), die für das Screening erforderlich sind. skipped_blocked: type: integer description: 'Übersprungen: Der Benutzer ist gesperrt.' skipped_sandbox: type: integer description: >- Übersprungen: Sandbox-Anwendung, es wird kein Screening erstellt. failed_provider: type: integer description: >- Das Screening konnte nicht abgeschlossen werden; versuchen Sie es später erneut. failed_insufficient_balance: type: integer description: Das Guthaben wurde aufgebraucht, während der Auftrag lief. results: type: array description: >- Ein Eintrag pro verarbeitetem Profil, in der Reihenfolge der Verarbeitung. Wächst, während der Job läuft; vollständig, sobald der Status COMPLETED ist. Erfasst für Jobs, die über die API gestartet wurden. items: type: object properties: didit_internal_id: type: string format: uuid description: Interne Didit-ID des Profils. vendor_data: type: string nullable: true description: Ihre eigene Kennung für das Profil. 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: >- Generische Fehlermeldung, wenn der Status FAILED lautet; die detaillierte Ursache verbleibt auf Plattformseite. created_at: type: string format: date-time completed_at: type: string format: date-time nullable: true estimate: type: object description: >- Kostenvorschau. Wird direkt zurückgegeben, wenn estimate_only wahr ist (es wird nichts geschrieben). properties: users_total: type: integer description: Profile, die der Auswahl entsprechen. already_enabled: type: integer description: >- Profile, die bereits überwacht werden (beim Aktivieren ist nichts zu tun; diese werden beim Deaktivieren abgeschaltet). with_existing_aml: type: integer description: >- Profile, deren bestehendes AML-Screening auf überwacht umgestellt wird (kein neues Screening). needing_screening: type: integer description: >- Profile ohne bisheriges AML-Screening, die zuerst gescreent werden (abgerechnet als reguläres AML-Screening). skipped_no_identity_data: type: integer description: >- Profile, die nicht gescreent werden können, da Identitätsdaten fehlen. skipped_blocked: type: integer description: >- Gesperrte Benutzer, die übersprungen werden (bei Unternehmen immer 0). estimated_screening_cost_usd: type: number example: 0.2 description: Einmalige Kosten für die neuen Screenings. estimated_annual_monitoring_cost_usd: type: number example: 0.07 description: >- Jährliche Überwachungskosten für die Profile, die künftig überwacht werden. balance_sufficient: type: boolean description: >- Gibt an, ob das Guthaben der Organisation das Screening plus das erste Jahr der Überwachung abdeckt. unmatched: type: array items: type: string description: >- Kennungen der Anfrage, die mit keinem Profil in dieser Anwendung übereinstimmten, exakt wie gesendet. Sie sind nicht Teil des Auftrags. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.