> ## 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. # MitID personal Verifizierungs-API > MitID-personal-Verifizierung mit Didit in Ihre Anwendung integrieren. Länder, Schritte, Ergebnisse und Preise im Überblick. Starten Sie die persönliche MitID-Verifizierung über Ihr Backend mit dem Anwendungs-API-Schlüssel. Sie benötigen keinen Workflow und keine `workflow_id`. Die Antwort auf den Start beschreibt die nächste Authentifizierungsaktion; sie ist kein genehmigtes Identitätsergebnis. ## Abdeckung und Aktivierung | Eigenschaft | Wert | | - | - | | Wallet | MitID personal | | Wallet-ID | `mitid` | | Länder | ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/dk.svg)Dänemark | | Aktivierung der Produktions-Wallet | ✅ Verfügbar | | Veröffentlichter Wallet-Preis | \$0.25 pro abgeschlossene Verifizierung | Die Aktivierung der Wallet ist unabhängig von der API-Bereitstellung und der Berechtigung Ihrer Anwendung. Ein dokumentierter Endpoint aktiviert keine Wallet, die als demnächst verfügbar gekennzeichnet ist. Die aktuellen veröffentlichten Tarife finden Sie unter [Preise für digitale ID-Wallets](https://docs.didit.me/de/getting-started/pricing.md#preise-für-digital-id-wallets). ## Was die Person tut Folgen Sie der nächsten Aktion, die die Startanfrage zurückgibt. Die Authentifizierungsoberfläche der Wallet bestimmt, ob die Person einen Browser, ein anderes Gerät oder eine App verwendet. ## Ergebnis empfangen Folgen Sie dem [Leitfaden zur Digital-ID-Wallet-API](https://docs.didit.me/de/standalone-apis/digital-id-wallets.md), um die Verifizierung nachzuverfolgen und ihr Ergebnis abzurufen. Betrachten Sie nur ein abgeschlossenes, verifiziertes Ergebnis als Nachweis, dass die Wallet die Person authentifiziert hat. Die zurückgegebenen Identitätsattribute variieren je nach Wallet; gehen Sie nicht davon aus, dass eine Adresse, ein Porträt oder alle angefragten Attribute vorhanden sind. ## Verwandte Themen * [Digital-ID-Wallet-APIs](https://docs.didit.me/de/standalone-apis/digital-id-wallets.md) * [Wallet-Abdeckung und Attribute](https://docs.didit.me/de/core-technology/id-verification/digital-id-wallets.md) * [Preise](https://docs.didit.me/de/getting-started/pricing.md#preise-für-digital-id-wallets) ## OpenAPI ````yaml de/openapi-25.json POST /v3/id-verification/wallets/mitid/ 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/id-verification/wallets/mitid/: post: tags: - Digital ID wallets summary: MitID-Verifizierung starten description: >- Starten Sie eine MitID-Anmeldung (Danish Agency for Digital Government; DNK) ohne Workflow. Die Abrechnung erfolgt einmalig, nur wenn die Identität verifiziert wurde. Die Antwort enthält next_action.type=redirect mit der URL, an die der Browser des Benutzers weitergeleitet werden soll; der Benutzer kehrt zu return_url zurück, an die request_id und result angehängt werden. Lesen Sie das Ergebnis mit GET /v3/id-verification/wallets/verifications/{request_id}/ oder aus dem Webhook aus, niemals aus der URL. Sandbox-Anwendungen erhalten eine deterministische Simulation (simulated: true), die den Anbieter niemals kontaktiert. operationId: start_mitid_wallet_verification parameters: - in: header name: Idempotency-Key schema: type: string description: >- Optionaler Schlüssel zur Wiederholungssicherheit (max. 255 Zeichen). Ein erneuter Versuch mit demselben Schlüssel, derselben Wallet und demselben Body gibt die ursprüngliche Verifizierung zurück, ohne eine zweite Anmeldung zu starten; derselbe Schlüssel mit einer anderen Wallet oder einem anderen Body gibt 409 idempotency_key_reused zurück. requestBody: content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiMitidWalletVerificationStartRequest example: country: DNK vendor_data: your-customer-reference metadata: reference: example return_url: https://app.example.com/identity/complete application/x-www-form-urlencoded: schema: $ref: >- #/components/schemas/DigitalIdWalletApiMitidWalletVerificationStartRequest multipart/form-data: schema: $ref: >- #/components/schemas/DigitalIdWalletApiMitidWalletVerificationStartRequest required: true responses: '201': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationResponse example: request_id: 00000000-0000-4000-8000-000000000001 wallet_verification: wallet: id: mitid name: MitID issuing_authority: Danish Agency for Digital Government country: DNK status: Not Finished outcome: pending error: null interaction: redirect simulated: false expires_at: '2026-01-01T10:10:00Z' next_action: type: redirect url: https://wallet.example.com/authorize identity: null attributes: null level_of_assurance: null verified_at: null signature_valid: null credential_type: person_identification vendor_data: your-customer-reference metadata: reference: example created_at: '2026-01-01T10:00:00Z' description: '' '400': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationStartBadRequest description: >- Feldvalidierungsfehler ({field: [messages]}) oder Fehler return_url_invalid, return_url_not_allowed, invalid_personal_code, invalid_phone_number oder idempotency_key_invalid. '403': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationStartForbidden description: >- Fehlende Anmeldedaten ({detail}) oder Fehler wallet_unavailable, insufficient_credits oder contract_rate_missing. '409': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- Fehler idempotency_key_reused oder idempotency_key_in_progress (mit Retry-After). '502': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- Fehler wallet_provider_unavailable: Der Anbieter konnte nicht gestartet werden; es wurde nichts erstellt. '503': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- Fehler wallet_not_configured: Diese Umgebung kann die Wallet nicht erreichen. security: - ApiKeyAuth: [] - BearerAuth: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request POST \ --url https://verification.didit.me/v3/id-verification/wallets/mitid/ \ --header 'x-api-key: YOUR_API_KEY' \ --header 'Idempotency-Key: your-unique-attempt-key' \ --header 'Content-Type: application/json' \ --data '{ "country": "DNK", "vendor_data": "your-customer-reference", "metadata": { "reference": "example" }, "return_url": "https://app.example.com/identity/complete" }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.id_wallets.start_mitid( vendor_data="your-customer-reference", metadata={"reference": "example"}, country="DNK", return_url="https://app.example.com/identity/complete", ) 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.idWallets.startMitid({ vendor_data: "your-customer-reference", metadata: { reference: "example" }, country: "DNK", return_url: "https://app.example.com/identity/complete", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.IDWallets.StartMitid(ctx, didit.IDWalletsStartMitidParams{\n\tBody: didit.DigitalIDWalletAPIMitidWalletVerificationStartRequest{\n\t\tVendorData: didit.String(\"your-customer-reference\"),\n\t\tMetadata: didit.Some(map[string]any{\"reference\": \"example\"}),\n\t\tCountry: didit.Some(didit.DigitalIDWalletAPIMitidWalletVerificationStartCountryEnum(\"DNK\")),\n\t\tReturnURL: \"https://app.example.com/identity/complete\",\n\t},\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import java.util.Map; import me.didit.Didit; import me.didit.types.DigitalIdWalletApiMitidWalletVerificationStartCountryEnum; import me.didit.types.DigitalIdWalletApiMitidWalletVerificationStartRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.idWallets().startMitid(DigitalIdWalletApiMitidWalletVerificationStartRequest.builder() .vendorData("your-customer-reference") .metadata(Map.of("reference", "example")) .country(DigitalIdWalletApiMitidWalletVerificationStartCountryEnum.of("DNK")) .returnUrl("https://app.example.com/identity/complete") .build()); System.out.println(result); - lang: php label: PHP source: |- idWallets->startMitid([ 'vendor_data' => 'your-customer-reference', 'metadata' => ['reference' => 'example'], 'country' => 'DNK', 'return_url' => 'https://app.example.com/identity/complete', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.id_wallets.start_mitid( vendor_data: "your-customer-reference", metadata: { reference: "example" }, country: "DNK", return_url: "https://app.example.com/identity/complete" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Collections.Generic; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.IdWallets.StartMitidAsync(new DigitalIdWalletApiMitidWalletVerificationStartRequest { VendorData = "your-customer-reference", Metadata = new Dictionary { ["reference"] = "example" }, Country = new DigitalIdWalletApiMitidWalletVerificationStartCountryEnum("DNK"), ReturnUrl = "https://app.example.com/identity/complete", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: DigitalIdWalletApiMitidWalletVerificationStartRequest: type: object description: Starten Sie eine MitID-Verifizierung (DNK). properties: vendor_data: type: string nullable: true description: >- Ihre eigene Referenz für diese Verifizierung (z. B. Ihre Benutzer-ID). Wird in Ergebnissen und Webhooks zurückgegeben. metadata: type: object additionalProperties: {} nullable: true description: >- Optionales JSON-Objekt, das mit der Verifizierung gespeichert und in Ergebnissen sowie Webhooks zurückgegeben wird. sandbox_scenario: type: string minLength: 1 description: >- Nur für Sandbox-Anwendungen: Das simulierte Ergebnis – 'wallet_cancelled', 'wallet_timeout' oder 'wallet_provider_error'; jedes andere Szenario (oder keines) verifiziert erfolgreich. Bei Live-Anwendungen abgelehnt. Der vollständige Katalog ist unter GET /v1/sandbox/scenarios/ verfügbar. country: allOf: - $ref: >- #/components/schemas/DigitalIdWalletApiMitidWalletVerificationStartCountryEnum default: DNK description: >- ISO 3166-1-Alpha-3-Land der MitID-Identität. Standardmäßig DNK, das einzige Land, das unterstützt wird. * `DNK` - DNK return_url: type: string format: uri minLength: 1 description: >- HTTPS-URL, zu der der Browser des Benutzers nach der Wallet zurückkehrt, wobei request_id und result angehängt werden. Ihr Host muss in den allowed_return_hosts der Anwendung registriert sein (oder deren White-Label-Domain sein). Vertrauen Sie result niemals allein: Rufen Sie das Ergebnis mit GET .../verifications/{request_id}/ oder über den Webhook ab. maxLength: 2048 device: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiDeviceEnum' default: same_device description: >- same_device, wenn sich der Benutzer auf dem Gerät anmeldet, das Ihre Seite anzeigt; cross_device, wenn er ein anderes Gerät verwendet (z. B. den QR-Code von BankID). * `same_device` - same_device * `cross_device` - cross_device required: - return_url DigitalIdWalletApiWalletVerificationResponse: type: object description: >- Eine eigenständige Wallet-Verifizierung, wie sie von jedem Wallet-Endpoint beantwortet wird. properties: request_id: type: string format: uuid wallet_verification: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationResult' vendor_data: type: string nullable: true metadata: type: object additionalProperties: {} nullable: true description: Das beim Start gesendete Metadaten-Objekt oder null. created_at: type: string format: date-time required: - created_at - metadata - request_id - vendor_data - wallet_verification DigitalIdWalletApiWalletVerificationStartBadRequest: oneOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' - $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationFieldErrors' DigitalIdWalletApiWalletVerificationStartForbidden: oneOf: - $ref: >- #/components/schemas/DigitalIdWalletApiClientCredentialsForbiddenErrorMessage - $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' DigitalIdWalletApiWalletVerificationError: type: object properties: error: type: string description: Stabiler maschinenlesbarer Code, z. B. wallet_unavailable. detail: type: string required: - detail - error DigitalIdWalletApiMitidWalletVerificationStartCountryEnum: enum: - DNK type: string description: '* `DNK` - DNK' DigitalIdWalletApiDeviceEnum: enum: - same_device - cross_device type: string description: |- * `same_device` - same_device * `cross_device` - cross_device DigitalIdWalletApiWalletVerificationResult: type: object properties: wallet: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWallet' readOnly: true country: type: string status: type: string description: >- Nicht abgeschlossen, solange ausstehend, dann genehmigt (verifiziert) oder abgelehnt. outcome: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationResultOutcomeEnum error: type: string nullable: true readOnly: true interaction: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiInteractionEnum' readOnly: true simulated: type: boolean readOnly: true expires_at: type: string format: date-time next_action: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletNextAction' nullable: true readOnly: true identity: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletIdentity' nullable: true readOnly: true attributes: type: object additionalProperties: {} nullable: true readOnly: true level_of_assurance: type: string nullable: true verified_at: type: string format: date-time nullable: true signature_valid: type: boolean nullable: true description: >- True, sobald die Signatur der Zugangsdaten verifiziert wurde; null bei simulierten Zugangsdaten. credential_type: type: string nullable: true required: - attributes - country - credential_type - error - expires_at - identity - interaction - level_of_assurance - next_action - outcome - signature_valid - simulated - status - verified_at - wallet DigitalIdWalletApiWalletVerificationFieldErrors: type: object description: >- Validierungsfehler der Anfrage: jedes abgelehnte Feld mit seinen Meldungen. additionalProperties: type: array items: type: string DigitalIdWalletApiClientCredentialsForbiddenErrorMessage: type: object properties: detail: type: string default: Forbidden - User doesn't have permission DigitalIdWalletApiWallet: type: object properties: id: type: string description: Katalog-ID der Wallet, z. B. bankid_se. name: type: string issuing_authority: type: string nullable: true required: - id - issuing_authority - name DigitalIdWalletApiWalletVerificationResultOutcomeEnum: enum: - pending - verified - cancelled - timeout - failed type: string description: |- * `pending` - Ausstehend * `verified` - Verifiziert * `cancelled` - Vom Benutzer abgebrochen * `timeout` - Zeitüberschreitung * `failed` - Fehlgeschlagen DigitalIdWalletApiInteractionEnum: enum: - redirect - in_app - digital_credentials type: string description: |- * `redirect` - redirect * `in_app` - in_app * `digital_credentials` - digital_credentials DigitalIdWalletApiWalletNextAction: type: object properties: type: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletNextActionTypeEnum' description: >- redirect: Leiten Sie den Browser des Benutzers an url weiter. confirm_in_app: Zeigen Sie dem Benutzer verification_code an, der prüft, ob er mit dem Code in seiner Wallet-App übereinstimmt, und dort bestätigt; dann per Polling abfragen. request_digital_credential: Bei einer Benutzeraktion auf dem Ursprung, mit dem Sie begonnen haben, die Wallet mit digital_credentials.request abfragen und das Ergebnis an POST .../verifications/{request_id}/response/ senden. * `redirect` - redirect * `confirm_in_app` - confirm_in_app * `request_digital_credential` - request_digital_credential url: type: string format: uri description: 'Nur redirect: wo sich der Benutzer mit der Wallet anmeldet.' digital_credentials: allOf: - $ref: >- #/components/schemas/DigitalIdWalletApiWalletDigitalCredentialsRequest description: >- Nur request_digital_credential: die an die Wallet zu übergebende Anfrage. verification_code: type: string description: >- Nur confirm_in_app: Der 4-stellige Vergleichscode, den auch die Wallet-App anzeigt. poll_interval_seconds: type: integer description: >- Nur confirm_in_app: Wie oft POST .../verifications/{request_id}/poll/ für zeitnahes Feedback aufgerufen werden soll. Didit fragt ausstehende Anmeldungen auch im Hintergrund ab, sodass der Webhook das Ergebnis auch dann meldet, wenn Sie keine Abfragen durchführen. required: - type DigitalIdWalletApiWalletIdentity: type: object properties: full_name: type: string nullable: true first_name: type: string nullable: true last_name: type: string nullable: true date_of_birth: type: string format: date nullable: true nationality: type: string nullable: true description: >- ISO3-Staatsangehörigkeit, nur wenn die Wallet eine angibt (wird niemals abgeleitet). issuing_state: type: string description: ISO3-Land, dessen Schema die Identität ausgestellt hat. required: - date_of_birth - first_name - full_name - issuing_state - last_name - nationality DigitalIdWalletApiWalletNextActionTypeEnum: enum: - redirect - confirm_in_app - request_digital_credential type: string description: |- * `redirect` - redirect * `confirm_in_app` - confirm_in_app * `request_digital_credential` - request_digital_credential DigitalIdWalletApiWalletDigitalCredentialsRequest: type: object properties: protocol: type: string description: openid4vp-v1-signed. request: type: object additionalProperties: {} description: >- Unverändert übergeben: navigator.credentials.get({digital: request}) im Browser oder JSON.stringify(request) als requestJson von GetDigitalCredentialOption auf Android. Von Didit für Ihre Anwendung signiert. required: - protocol - request 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. BearerAuth: type: http scheme: bearer description: Das Client-Credentials-Zugriffstoken der Anwendung. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.