> ## 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. # Gegenpartei-VASP prüfen: Sanktions-API > Optionales, kostenpflichtiges Sanktions- und Negativmedien-Screening einer Travel-Rule-Gegenpartei-VASP mit Didit für Ihre Anwendung. Prompt für die VASP-Prüfung per API Prompt in die Zwischenablage kopieren \

\`Screen a Travel Rule counterparty VASP against sanctions and adverse media for my application.

Endpoint:
POST https://verification.didit.me/v3/travel-rule/vasps/{vasp_id}/screening/

Authentication:
Use the x-api-key header with my Didit API key.

Prerequisite:
Turn on counterparty screening first: PUT /v3/travel-rule/settings/ with {"counterparty_screening_enabled": true}. It is off by default.

Example call:
curl -X POST "https://verification.didit.me/v3/travel-rule/vasps/{vasp_id}/screening/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"refresh": false}'

Body (optional):
\- refresh - true screens again even when a fresh screening exists. Default false.

What happens:
\- 201 {"outcome": "screened", "screening": {...}} - a new screening ran and was billed at my organization's Company AML Screening price (GET .../screening/ returns the price).
\- 200 {"outcome": "reused", "screening": {...}} - a screening younger than 30 days already existed and was returned. Nothing was billed.
\- screening is {id, status, total_hits, score, screened_at, fresh, flagged}. status is Approved, In Review or Declined; flagged is true while a fresh screening is In Review or Declined.
\- While my latest screening is flagged and screening stays on, my rules read counterparty_risk_level as HIGH for this counterparty. The shared risk_level in the directory does not change.
\- The screening is private to my application: no other Didit customer sees it.
\- With screening on, Didit also screens the counterparty an outbound Travel Rule exchange reaches when the exchange starts, reusing a fresh screening and billing a new one the same way. A refusal or failure there never fails the transfer.

Failure modes (nothing runs and nothing is billed):
\- 400 - the counterparty has no name to screen, or the body is not valid.
\- 403 - my organization's balance cannot cover the screening (code insufficient_credits), or my contract has no rate configured for it.
\- 404 - no directory entry or listed Didit network member has this id, or the id is my own VASP profile.
\- 409 - counterparty screening is off, the application is a sandbox one, or a screening of this counterparty is already running.
\- 502 - the screening could not be completed; try again in a moment.

Full guide: /transaction-monitoring/travel-rule#counterparty-screening.`

\
Einfügen in ## OpenAPI ````yaml de/openapi-25.json POST /v3/travel-rule/vasps/{vasp_id}/screening/ 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/travel-rule/vasps/{vasp_id}/screening/: post: tags: - Travel Rule summary: Einen VASP screenen description: >- Überprüfen Sie die Gegenpartei-Entität für Ihre Anwendung auf Sanktionen und negative Medienberichte. Opt-in: counterparty_screening_enabled muss in Ihren Travel Rule-Einstellungen aktiviert sein. Jedes neue Screening wird zum Preis für das AML-Screening von Unternehmen Ihrer Organisation abgerechnet; stattdessen wird ein Screening zurückgegeben, das jünger als 30 Tage ist (200, nicht abgerechnet), es sei denn, Sie senden refresh: true. Pro Anwendung wird jeweils nur ein Screening einer Gegenpartei ausgeführt. Das Ergebnis ist für Ihre Anwendung privat. Sandbox-Anwendungen werden niemals überprüft. operationId: screenTravelRuleVasp parameters: - name: vasp_id in: path required: true schema: type: string format: uuid description: >- Die ID einer Zeile aus der Antwort von GET /v3/travel-rule/vasps/: ein Verzeichniseintrag oder ein Mitglied des Didit-Netzwerks. requestBody: required: false content: application/json: schema: $ref: '#/components/schemas/TravelRuleCounterpartyScreeningRequest' example: refresh: false responses: '200': description: >- Ein aktuelles Screening existierte bereits und wurde zurückgegeben. Es wurde nichts in Rechnung gestellt. content: application/json: schema: $ref: '#/components/schemas/TravelRuleCounterpartyScreeningResult' example: outcome: reused screening: id: 7a1d2c3b-4e5f-4a6b-8c7d-9e0f1a2b3c4d status: Approved total_hits: 0 score: null screened_at: '2026-10-14T09:58:00Z' fresh: true flagged: false '201': description: Ein neues Screening wurde durchgeführt und in Rechnung gestellt. content: application/json: schema: $ref: '#/components/schemas/TravelRuleCounterpartyScreeningResult' example: outcome: screened screening: id: 7a1d2c3b-4e5f-4a6b-8c7d-9e0f1a2b3c4d status: In Review total_hits: 2 score: 85 screened_at: '2026-10-14T09:58:00Z' fresh: true flagged: true '400': description: >- Der Body ist ungültig oder die Gegenpartei hat keinen Namen für das Screening. content: application/json: schema: type: object additionalProperties: type: array items: type: string example: detail: - This counterparty has no name to screen. '403': description: >- Das Guthaben Ihrer Organisation reicht für das Screening nicht aus (Code insufficient_credits; es wurde nichts ausgeführt und nichts abgerechnet), oder für Ihren Vertrag ist kein Tarif dafür konfiguriert. content: application/json: schema: type: object properties: detail: type: string code: type: string example: detail: >- You don't have enough credits to perform this request. Please top up at https://business.didit.me code: insufficient_credits '404': description: >- Kein Verzeichniseintrag und kein gelistetes Didit-Netzwerkmitglied besitzt diese ID. Ihr eigenes VASP-Profil ist niemals eine Gegenpartei von Ihnen. content: application/json: schema: type: object properties: detail: type: string example: detail: No directory entry or Didit network member has this id. '409': description: >- Es wurde nichts ausgeführt und nichts abgerechnet: Das Gegenpartei-Screening ist für Ihre Anwendung deaktiviert, die Anwendung ist eine Sandbox-Anwendung oder ein Screening dieser Gegenpartei wird bereits ausgeführt. content: application/json: schema: type: object properties: detail: type: string examples: Screening off: value: detail: >- Counterparty screening is turned off. Enable it in the Travel Rule settings first. Sandbox application: value: detail: >- Counterparty screening does not run for sandbox applications. Already running: value: detail: >- A screening of this counterparty is already running. Try again in a moment. '502': description: >- Das Screening konnte nicht abgeschlossen werden. Es wurde nichts in Rechnung gestellt; versuchen Sie es gleich noch einmal. content: application/json: schema: type: object properties: detail: type: string example: detail: The screening provider did not answer. Try again in a moment. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST https://verification.didit.me/v3/travel-rule/vasps/{vasp_id}/screening/ \ -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \ -d '{"refresh": false}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.travel_rule.screen_vasp( "11111111-2222-3333-4444-555555555555", refresh=False, ) 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.travelRule.screenVasp("11111111-2222-3333-4444-555555555555", { refresh: false, }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.TravelRule.ScreenVASP(ctx, \"11111111-2222-3333-4444-555555555555\", didit.TravelRuleCounterpartyScreeningRequest{\n\tRefresh: didit.Bool(false),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.TravelRuleCounterpartyScreeningRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.travelRule().screenVasp("11111111-2222-3333-4444-555555555555", TravelRuleCounterpartyScreeningRequest.builder() .refresh(false) .build()); System.out.println(result); - lang: php label: PHP source: >- travelRule->screenVasp('11111111-2222-3333-4444-555555555555', [ 'refresh' => false, ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.travel_rule.screen_vasp( "11111111-2222-3333-4444-555555555555", refresh: false ) 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.TravelRule.ScreenVaspAsync("11111111-2222-3333-4444-555555555555", new TravelRuleCounterpartyScreeningRequest { Refresh = false, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: TravelRuleCounterpartyScreeningRequest: type: object properties: refresh: type: boolean default: false description: >- true führt ein erneutes Screening durch (und rechnet erneut ab), selbst wenn ein aktuelles Screening vorliegt. TravelRuleCounterpartyScreeningResult: type: object properties: outcome: type: string enum: - screened - reused description: >- screened: Ein neues Screening wurde durchgeführt und abgerechnet (201). reused: Ein aktuelles Screening wurde zurückgegeben und nicht abgerechnet (200). screening: $ref: '#/components/schemas/TravelRuleCounterpartyScreening' TravelRuleCounterpartyScreening: type: object description: >- Ein Screening auf Sanktionen und negative Medienberichte der Gegenpartei-Entität, für Ihre Anwendung durchgeführt und ihr in Rechnung gestellt. Nur für Ihre Anwendung sichtbar: Ein anderer Kunde sieht dies niemals. properties: id: type: string format: uuid status: type: string enum: - Approved - In Review - Declined description: >- Genehmigt: Kein möglicher Treffer erfordert Aufmerksamkeit. In Prüfung oder Abgelehnt: Ein möglicher Treffer bei Sanktionen oder negativen Medienberichten. total_hits: type: integer description: Wie viele mögliche Treffer das Screening zurückgegeben hat. score: type: number nullable: true description: >- Der höchste Risiko-Score unter den möglichen Übereinstimmungen. Null, wenn nichts übereinstimmte. screened_at: type: string format: date-time fresh: type: boolean description: >- Gibt an, ob das Screening neuer als fresh_days (30 Tage) ist. Ein frisches Screening wird wiederverwendet, anstatt erneut abgerechnet zu werden. flagged: type: boolean description: >- true, solange das Screening aktuell ist und sein Status In Review oder Declined lautet. Solange Ihr neuestes Screening markiert ist und das Gegenpartei-Screening aktiv bleibt, ist counterparty_risk_level in Ihren Regeln HIGH. 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.