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

# FIU-Bericht löschen API

> Löscht einen Entwurf oder finalisierten regulatorischen Bericht in Didit, inklusive kopiertem Narrativ, Transaktionsverknüpfungen, goAML-XML und PDF.



API-Prompt zum Löschen eines Berichts
        Prompt in die Zwischenablage kopieren



      
      

\<pre>

\`Delete a regulatory (FIU) report through the Management API.

Endpoint:
DELETE https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/regulatory-reports/{report_uuid}/

Authentication:
Use the x-api-key header with my Didit API key. The key must carry write:cases.

Request body:
A draft or validated report can be deleted without a body.
A finalized report requires:
\{"confirm_delete": true}

Example call:
curl -X DELETE "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/regulatory-reports/{report_uuid}/" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"confirm_delete": true}'

What is deleted:
\- The report, its copied narrative, reasons and other report fields.
\- Its links to transactions.
\- Its generated goAML XML and PDF, including every stored version of those files.
The report disappears from report lists, and previously issued download URLs stop working. The case, transactions, people and companies are NOT deleted. Deletion is permanent and cannot be undone.

Failure modes:
\- 400 - a finalized report was sent without confirm_delete: true. Nothing is deleted.
\- 403 - the key cannot delete reports (requires write:cases).
\- 404 - the report does not exist in this application or was already deleted.
\- 409 - code report_deletion_pending: the report is already being deleted. Repeat the request to finish.
\- 503 - code report_storage_unavailable: the report files could not be erased right now. The report is still in place. Repeat the request.

After deletion:
A delete of a person, company, transaction, case or session that was blocked by this report can be repeated. See Delete Users, Delete Businesses, Batch Delete Transactions, Delete Case and Delete Session.

For the full integration shape, see /integration/integration-prompt.`

\</pre>



      
      

Einfügen in

Löschen Sie einen regulatorischen Bericht dauerhaft.## Was gelöscht wirdDer Bericht, seine kopierte Sachverhaltsbeschreibung (Narrative), die Begründungen und die übrigen Berichtsfelder, seine Verknüpfungen mit Transaktionen sowie die erzeugten goAML-XML- und PDF-Dateien. Jede gespeicherte Version dieser Dateien wird gelöscht. Der Bericht verschwindet aus den Berichtslisten, und zuvor ausgegebene Download-URLs funktionieren nicht mehr.Der Fall, die Transaktionen, die Personen und die Unternehmen werden **nicht** gelöscht. Der Bericht nimmt deren Daten nicht mit. Die Löschung ist dauerhaft und unwiderruflich.## BestätigungEin Bericht im Entwurfs- oder validierten Status wird ohne Anfragekörper (Request-Body) gelöscht.Zum Löschen eines finalisierten Berichts ist eine ausdrückliche Bestätigung erforderlich:```json theme={null}
{ "confirm_delete": true }
```Ohne diese Bestätigung gibt ein finalisierter Bericht `400` zurück, und es wird nichts gelöscht.## Wenn die Dateien jetzt nicht gelöscht werden könnenEin `503` mit `code: report_storage_unavailable` bedeutet, dass die Berichtsdateien jetzt nicht gelöscht werden konnten. Der Bericht ist weiterhin vorhanden. Wiederholen Sie die Anfrage. Ein `409` mit `code: report_deletion_pending` bedeutet, dass eine Löschung dieses Berichts bereits läuft. Wiederholen Sie die Anfrage, um sie abzuschließen.## Eine blockierte Löschung auflösenGibt ein Löschvorgang für eine Person, ein Unternehmen, eine Transaktion, einen Fall oder eine Sitzung `409` mit `code: in_filed_report` zurück, nennt die Antwort die Berichte, die diese Daten enthalten. Löschen Sie hier jeden dieser Berichte und wiederholen Sie dann den blockierten Löschvorgang.## Verwandte Themen- [Berichte auflisten](https://docs.didit.me/de/management-api/regulatory-reports/list.md)
- [Bericht finalisieren](https://docs.didit.me/de/management-api/regulatory-reports/finalize.md)
- [Fall löschen](https://docs.didit.me/de/management-api/cases/delete.md)
- [Transaktionen im Stapel löschen](https://docs.didit.me/de/management-api/transactions/delete.md)


## OpenAPI

````yaml de/openapi-25.json DELETE /v3/organization/{organization_id}/application/{application_id}/regulatory-reports/{report_uuid}/
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/organization/{organization_id}/application/{application_id}/regulatory-reports/{report_uuid}/:
    delete:
      tags:
        - Regulatory Reports
      summary: Bericht löschen
      description: >-
        Einen regulatorischen Bericht dauerhaft löschen. Der Bericht, seine
        kopierte Sachverhaltsschilderung und Gründe, seine
        Transaktionsverknüpfungen sowie seine generierten goAML-XML- und
        PDF-Dateien werden gelöscht, einschließlich jeder gespeicherten Version
        dieser Dateien. Der Bericht verschwindet aus Listen und Download-URLs
        funktionieren nicht mehr. Andere Datensätze, einschließlich des Falls,
        Transaktionen, Personen und Unternehmen, werden nicht gelöscht. Ein
        Rückgängigmachen ist nicht möglich.


        Ein Berichtsentwurf oder ein validierter Bericht kann ohne Anfrage-Body
        gelöscht werden. Das Löschen eines finalisierten Berichts erfordert
        `confirm_delete: true` im Anfrage-Body. Wird der Bericht nicht gefunden,
        gibt die Anfrage `404` zurück; wird ein finalisierter Bericht ohne
        Bestätigung gesendet, gibt sie `400` zurück und es wird nichts gelöscht.
      operationId: delete_regulatory_report
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID der Organisation.
        - name: application_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Anwendungs-UUID.
        - name: report_uuid
          in: path
          required: true
          schema:
            type: string
            format: uuid
            example: 5ec00000-0000-4000-8000-000000000007
          description: Berichts-UUID.
      requestBody:
        required: false
        description: Nur für einen finalisierten Bericht erforderlich.
        content:
          application/json:
            schema:
              type: object
              properties:
                confirm_delete:
                  type: boolean
                  description: >-
                    Auf true setzen, um zu bestätigen, dass ein finalisierter
                    Bericht und seine generierten Dateien dauerhaft gelöscht
                    werden.
              example:
                confirm_delete: true
            example:
              confirm_delete: true
      responses:
        '204':
          description: Bericht gelöscht, einschließlich seiner generierten Dateien.
        '400':
          description: >-
            Ein finalisierter Bericht wurde ohne `confirm_delete: true`
            gesendet. Es wird nichts gelöscht.
          content:
            application/json:
              schema:
                type: object
                properties:
                  confirm_delete:
                    type: array
                    items:
                      type: string
              example:
                confirm_delete:
                  - This field is required to delete a finalized report.
        '403':
          description: >-
            Der API-Schlüssel kann keine Berichte löschen. Der Endpoint
            erfordert `write:cases`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
        '404':
          description: Bericht in dieser Anwendung nicht gefunden.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
        '409':
          description: >-
            Der Bericht wird bereits gelöscht. Wiederholen Sie die Anfrage, um
            das Löschen seiner Dateien abzuschließen.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
              example:
                detail: >-
                  This report is being deleted. Retry deleting it to finish
                  erasing its files.
                code: report_deletion_pending
        '503':
          description: >-
            Die Berichtdateien konnten derzeit nicht gelöscht werden. Der
            Bericht ist weiterhin vorhanden. Wiederholen Sie die Anfrage.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
              example:
                detail: >-
                  The report files could not be erased. Please retry deleting
                  the report.
                code: report_storage_unavailable
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl (draft report)
          source: >-
            curl -X DELETE
            'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/regulatory-reports/5ec00000-0000-4000-8000-000000000007/'
            \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: curl
          label: curl (finalized report)
          source: >-
            curl -X DELETE
            'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/regulatory-reports/5ec00000-0000-4000-8000-000000000007/'
            \
              -H 'x-api-key: YOUR_API_KEY' \
              -H 'Content-Type: application/json' \
              -d '{"confirm_delete": true}'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            # and DIDIT_APPLICATION_ID.
            client = Didit()

            client.regulatory_reports.delete(
                "5ec00000-0000-4000-8000-000000000007",
                confirm_delete=True,
            )
        - lang: javascript
          label: Node.js
          source: >-
            import Didit from "@didit-protocol/sdk-node";


            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID

            // and DIDIT_APPLICATION_ID.

            const didit = new Didit();


            await
            didit.regulatoryReports.delete("5ec00000-0000-4000-8000-000000000007",
            {
              confirm_delete: true,
            });
        - lang: java
          label: Java
          source: >-
            import me.didit.Didit;

            import me.didit.types.RegulatoryReportsDeleteParams;


            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID

            // and DIDIT_APPLICATION_ID.

            Didit client = new Didit();


            client.regulatoryReports().delete("5ec00000-0000-4000-8000-000000000007",
            RegulatoryReportsDeleteParams.builder()
                    .confirmDelete(true)
                    .build());
        - lang: php
          label: PHP
          source: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID

            // and DIDIT_APPLICATION_ID.

            $didit = new DiditClient();


            $didit->regulatoryReports->delete('5ec00000-0000-4000-8000-000000000007',
            [
                'confirm_delete' => true,
            ]);
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            # and DIDIT_APPLICATION_ID.
            didit = Didit::Client.new

            didit.regulatory_reports.delete(
              "5ec00000-0000-4000-8000-000000000007",
              confirm_delete: true
            )
        - lang: csharp
          label: .NET
          source: >-
            using System;

            using Didit;


            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID

            // and DIDIT_APPLICATION_ID.

            using var client = new DiditClient();


            await
            client.RegulatoryReports.DeleteAsync("5ec00000-0000-4000-8000-000000000007",
            new RegulatoryReportsDeleteParams

            {
                ConfirmDelete = true,
            });
components:
  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.