> ## 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. # Listen-API: Sperrlisten & Allowlists abrufen > Didit: GET /v3/lists/ liefert alle Sperrlisten, Allowlists und eigene Listen Ihrer Anwendung. Filter nach Listentyp. Abrechnung pro Aufruf. Prompt für die „List Lists API“ Prompt in die Zwischenablage kopieren \

\`Retrieve every blocklist, allowlist, and custom list in my Didit application through the Management API.

Endpoint:
GET https://verification.didit.me/v3/lists/

Authentication:
Use the x-api-key header with my Didit API key. A scoped API key needs workflows: read.

Goal:
\- Get a paginated list of all lists for my application so I can find a specific list's uuid, filter by type, or render a picker.

Behavior:
\- Returns the application's active lists, newest first by default. Deleted lists never appear.
\- Includes the system lists Didit provisions (is_system: true): one blocklist per entry type, the "High Risk Countries" custom list, and any system allowlist.
\- Paginated with limit (default 50) and offset. Follow next until it is null.

Query parameters (all optional):
\- list_type: "blocklist" | "allowlist" | "custom".
\- entry_type: face, document, phone, email, ip_address, device_fingerprint, wallet_address, bank_account, country, user, business, key.
\- ordering: created_at or -created_at (default).
\- limit: page size (default 50, at most 1000000).
\- offset: pagination offset (default 0).

Example call:
curl -X GET "https://verification.didit.me/v3/lists/?list_type=blocklist" \
-H "x-api-key: YOUR_API_KEY"

What to read from the response:
\- count / next / previous: standard pagination envelope.
\- results[].uuid: list id; use it as list_uuid in the list and entry calls.
\- results[].is_system: true for the lists Didit provisions. System lists cannot be renamed, edited or deleted, but you can add and remove their entries.
\- results[].entry_count, last_entry_added_at: computed over the list's current entries; useful for dashboards.

Failure modes:
\- 400: an unknown list_type or entry_type value, or limit/offset above 1000000.
\- 401: the API key has expired.
\- 403: missing x-api-key (a wrong, revoked or expired key gets 401) ({ "detail": "You do not have permission to perform this action." }), or a scoped key without workflows: read.
\- 429: rate limited (see /integration/rate-limiting); back off and retry.

Side effects: none. This is a pure read.

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

\
Einfügen in Rufen Sie eine paginierte Liste aller aktiven Listen Ihrer Anwendung ab: die von Didit bereitgestellten Systemlisten (eine Sperrliste pro Eintragstyp, die **High Risk Countries**-Liste und jede Systemallowlist) sowie die Allowlists und benutzerdefinierten Listen, die Sie erstellt haben. Filtern Sie nach `list_type` oder `entry_type`, und lesen Sie die Werte einer Liste mit [Listeneinträgen](https://docs.didit.me/de/management-api/lists/list-entries.md).Informationen dazu, was die einzelnen Listentypen bei der Verifizierung und beim Transaktions-Screening bewirken, finden Sie unter [Listen](https://docs.didit.me/de/management-api/lists/overview.md). ## OpenAPI ````yaml de/openapi-25.json GET /v3/lists/ 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/lists/: get: tags: - Lists summary: Listen auflisten description: >- Gibt die Listen der Anwendung zurück, die neuesten zuerst: die von Didit bereitgestellten Systemlisten (eine Sperrliste pro Eintragstyp, die benutzerdefinierte Liste **High Risk Countries** und etwaige System-Positivlisten) sowie die von Ihnen erstellten Positivlisten und benutzerdefinierten Listen. Filtern Sie mit `list_type` und `entry_type`; gelöschte Listen werden nie angezeigt. Die Ergebnisse werden mit `limit` und `offset` paginiert. Ein API-Schlüssel mit eingeschränktem Berechtigungsumfang benötigt `workflows: read`. Unter [Listen](https://docs.didit.me/de/management-api/lists/overview) erfahren Sie, wozu die einzelnen Listentypen dienen. operationId: list_lists parameters: - name: list_type in: query required: false description: Nur Listen dieses Typs. schema: type: string enum: - blocklist - allowlist - custom - name: entry_type in: query required: false description: Nur Listen dieses Eintragstyps. schema: type: string enum: - face - document - phone - email - ip_address - device_fingerprint - wallet_address - bank_account - country - user - business - key - name: ordering in: query required: false description: >- Sortierreihenfolge: `-created_at` (neueste zuerst, Standardwert) oder `created_at` (älteste zuerst). schema: type: string enum: - '-created_at' - created_at default: '-created_at' - name: limit in: query required: false description: >- Seitengröße. Standardmäßig 50. Ein Wert über 1000000 gibt `400` zurück; 0, ein negativer oder ein nicht-numerischer Wert fällt auf 50 zurück. schema: type: integer default: 50 minimum: 1 maximum: 1000000 - name: offset in: query required: false description: >- Nullbasierter Index des ersten zurückzugebenden Elements. Folgen Sie vorzugsweise `next`. Ein Wert über 1000000 gibt `400` zurück; ein negativer oder nicht-numerischer Wert fällt auf 0 zurück. schema: type: integer maximum: 1000000 minimum: 0 default: 0 responses: '200': description: Eine Seite mit Listen. content: application/json: schema: type: object required: - count - next - previous - results properties: count: type: integer minimum: 0 description: Gesamtzahl der Listen, die den Filtern entsprechen. next: type: string format: uri nullable: true description: >- Absolute URL der nächsten Seite oder `null` auf der letzten Seite. previous: type: string format: uri nullable: true description: >- Absolute URL der vorherigen Seite oder `null` auf der ersten Seite. results: type: array items: $ref: '#/components/schemas/ComplianceList' examples: Lists: value: count: 2 next: null previous: null results: - uuid: 22222222-3333-4444-5555-666666666666 name: Trusted office IPs description: Office egress ranges list_type: allowlist entry_type: ip_address is_system: false entry_count: 3 last_entry_added_at: '2026-10-02T08:15:27.501334Z' created_at: '2026-09-30T13:20:45.889120Z' updated_at: '2026-09-30T13:20:45.889120Z' - uuid: 11111111-2222-3333-4444-555555555555 name: Face Blocklist description: >- Blocked biometric faces. When a face matching an entry in this list is detected during liveness verification, the session will be automatically declined. list_type: blocklist entry_type: face is_system: true entry_count: 12 last_entry_added_at: '2026-10-09T16:42:03.118204Z' created_at: '2026-01-14T10:02:11.402917Z' updated_at: '2026-01-14T10:02:11.402917Z' '400': description: Ein Abfrageparameter ist ungültig. content: application/json: examples: Unknown list type: value: list_type: - '"denylist" is not a valid choice.' Unsupported ordering: value: ordering: - '"name" is not a valid choice.' Limit too large: value: - limit must not exceed 1000000. '401': description: >- Der API-Schlüssel mit eingeschränktem Geltungsbereich ist abgelaufen. Andere Authentifizierungsfehler geben `403` zurück. content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- Der `x-api-key`-Header fehlt (ein falscher, widerrufener oder abgelaufener Schlüssel erhält `401`), oder ein berechtigungseingeschränkter API-Schlüssel verfügt nicht über `workflows: read` oder wird von einer IP-Adresse außerhalb seiner Zulassungsliste verwendet. content: application/json: examples: Missing or invalid API key: value: detail: You do not have permission to perform this action. Scoped key without workflows access: value: detail: This API key has no read access to workflows. '429': description: >- Das geteilte Leselimit von 600 Anfragen pro Minute pro API-Schlüssel wurde überschritten. Beachten Sie `Retry-After`, bevor Sie es erneut versuchen. content: application/json: examples: Rate limited: value: detail: >- GET request rate limit exceeded. You can make up to 600 requests per minute. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/lists/?list_type=blocklist' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() for item in client.lists.list(): print(item) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); for await (const item of didit.lists.list()) { console.log(item); } - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.Lists.ListAutoPaging(ctx, didit.ListsListParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: |- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); for (var item : client.lists().list()) { System.out.println(item); } - lang: php label: PHP source: |- lists->list() as $item) { print_r($item->toArray()); } - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.lists.list.auto_paging_each do |item| puts item.to_h end - lang: csharp label: .NET source: |- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); await foreach (var item in await client.Lists.ListAsync()) { Console.WriteLine(JsonSerializer.Serialize(item)); } components: schemas: ComplianceList: type: object description: >- Eine Sperrliste, Positivliste oder benutzerdefinierte Liste einer Anwendung. required: - uuid - name - description - list_type - entry_type - is_system - entry_count - last_entry_added_at - created_at - updated_at properties: uuid: type: string format: uuid description: >- Listen-Identifikator. Verwenden Sie ihn als `list_uuid` in den Listen- und Eintrag-Endpoints sowie als Wert einer Workflow- oder Transaktionsregel-Bedingung mit `value_type: "list"`. name: type: string maxLength: 255 description: Listenname, eindeutig unter den Listen der Anwendung. description: type: string description: Freitext-Beschreibung. Leere Zeichenkette, wenn nicht festgelegt. list_type: type: string enum: - blocklist - allowlist - custom description: >- `blocklist`: Eine Übereinstimmung lehnt die Sitzung oder Transaktion ab (nur Systemlisten, eine pro Eintragstyp). `allowlist`: Übereinstimmende Elemente gelten als vertrauenswürdig, beispielsweise überspringt eine Gesichts-Allowlist die Aktion für doppelte Gesichter; überschreibt niemals eine Sperrlisten-Übereinstimmung. `custom`: Wird in Workflow- und Transaktionsregel-Bedingungen verwendet (`value_type: "list"`). entry_type: type: string enum: - face - document - phone - email - ip_address - device_fingerprint - wallet_address - bank_account - country - user - business - key description: >- Was die Liste enthält: `face`, `document` (Dokumentennummer), `phone`, `email`, `ip_address` (Adresse oder CIDR-Bereich), `device_fingerprint`, `wallet_address`, `bank_account`, `country` (ISO 3166-1 Alpha-3), `user` oder `business` (Ihre `vendor_data`) oder `key` (eine beliebige Zeichenkette). Damit wird bestimmt, wie Eintragswerte validiert und abgeglichen werden. is_system: type: boolean description: >- `true` für die von Didit bereitgestellten Listen: eine Sperrliste pro Eintragstyp (`face`, `document`, `phone`, `email`, `ip_address`, `device_fingerprint`, `wallet_address`, `bank_account`, `user`, `business`), die benutzerdefinierte Liste **High Risk Countries** und System-Positivlisten. Systemlisten können weder umbenannt noch bearbeitet oder gelöscht werden; Sie können deren Einträge hinzufügen und löschen. entry_count: type: integer minimum: 0 description: Anzahl der Einträge, die sich derzeit in der Liste befinden. last_entry_added_at: type: string format: date-time nullable: true description: >- Wann der neueste aktuelle Eintrag hinzugefügt wurde. `null` bei einer leeren Liste. created_at: type: string format: date-time description: Wann die Liste erstellt wurde. updated_at: type: string format: date-time description: Wann die Liste zuletzt aktualisiert wurde. 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.