> ## 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. # Signiertes Dokument herunterladen: API für signierte PDF > Lade die signierte PDF eines Dokuments aus einem E-Signatur-Schritt einer KYC- oder KYB-Sitzung mit deinem API-Schlüssel herunter, mit Didit. Gibt das unterzeichnete PDF eines Dokuments zurück, sobald dessen Unterzeichner es unterzeichnet hat. Sie müssen die URL nicht selbst erstellen: Jedes unterzeichnete Dokument in der Entscheidung enthält seinen Pfad in `signatures[].documents[].signed_file`. ```bash theme={null} curl -L 'https://verification.didit.me/v3/session/{session_id}/signatures/{node_id}/documents/{document_id}/file/' \ -H 'x-api-key: YOUR_API_KEY' \ -o agreement-signed.pdf ``` Das PDF enthält das Dokument, das dem Unterzeichner angezeigt wurde, mit den eingeblendeten Feldwerten und der Nachweisseite (sofern der Schritt `signature_evidence_page` nicht deaktiviert ist). Ein Advanced (AES)-PDF enthält zusätzlich die PAdES-Signatur mit ihrem Zeitstempel. Ein Simple-PDF enthält keine digitale Signatur, kein Siegel und keinen Zeitstempel. Vor der Rückgabe prüft Didit die gespeicherte Datei anhand von `sha256_signed`. Wenn die gespeicherte Datei nicht mit dem Hash übereinstimmt, antwortet der Endpunkt mit `409` und `signature_document_changed`. Ein Dokument, das noch nicht unterzeichnet ist, gibt `404` mit `signature_not_signed` zurück. Nachdem Sie die [Sitzung gelöscht haben](https://docs.didit.me/de/sessions-api/delete-session.md), gibt die Route `404` zurück. ## Verwandte Themen * [E-Signatur-Bericht](https://docs.didit.me/de/core-technology/electronic-signature/report-electronic-signature.md#das-signierte-pdf): was das unterzeichnete PDF enthält. * [Signaturnachweis herunterladen](https://docs.didit.me/de/sessions-api/electronic-signature/download-evidence.md) * [Signaturen validieren](https://docs.didit.me/de/sessions-api/electronic-signature/validate-signatures.md) ## OpenAPI ````yaml de/openapi-25.json GET /v3/session/{sessionId}/signatures/{nodeId}/documents/{documentId}/file/ 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/session/{sessionId}/signatures/{nodeId}/documents/{documentId}/file/: get: tags: - Sessions summary: Ein signiertes Dokument herunterladen description: >- Laden Sie das signierte PDF eines Dokuments aus einem E-Signatur-Schritt herunter. Verwenden Sie den Pfad `signed_file` von `signatures[].documents[]` in der Entscheidung. Das PDF enthält das Dokument, das dem Unterzeichner angezeigt wurde, mit seinen eingestempelten Feldwerten sowie die Nachweisseite (sofern `signature_evidence_page` nicht deaktiviert ist). Ein Advanced-(AES-)PDF enthält zudem die PAdES-Signatur mit ihrem Zeitstempel; ein Simple-PDF enthält keine digitale Signatur, kein Siegel und keinen Zeitstempel. Didit prüft die Datei vor der Rückgabe anhand von `sha256_signed`. Funktioniert für Sitzungen der Benutzerverifizierung (KYC) und Unternehmensverifizierung (KYB). Erfordert `read:sessions`; Ihr API-Schlüssel funktioniert. Siehe den [E-Signatur-Bericht](/de/core-technology/electronic-signature/report-electronic-signature#signierte-dokumente-herunterladen). operationId: get_v3_session_signature_document_file parameters: - name: sessionId in: path required: true description: >- Die Sitzung zur Benutzerverifizierung (KYC) oder Unternehmensverifizierung (KYB). schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: nodeId in: path required: true description: 'Der E-Signatur-Schritt: `node_id` des Elements in `signatures[]`.' schema: type: string example: feature_signature - name: documentId in: path required: true description: '`id` des Dokuments in `signatures[].documents[]`.' schema: type: string format: uuid responses: '200': description: Das signierte PDF. headers: Content-Disposition: description: Anhang mit dem Dateinamen. schema: type: string example: attachment; filename="agreement-signed.pdf" content: application/pdf: schema: type: string format: binary '403': description: >- Fehlende Anmeldedaten oder Anmeldedaten, die diese Sitzung nicht lesen können. Ein fehlender Schlüssel führt zu einer `403`-Antwort; ein falscher, widerrufener oder abgelaufener Schlüssel führt zu einer `401`-Antwort. content: application/json: schema: type: object properties: detail: type: string example: detail: You do not have permission to perform this action. '404': description: >- Kein signiertes Dokument stimmt überein: Die Sitzung, der Schritt oder das Dokument existiert nicht, wurde gelöscht oder ist noch nicht signiert. content: application/json: schema: type: object properties: detail: type: string code: type: string examples: Not signed yet: summary: Der Unterzeichner hat nicht unterschrieben value: code: signature_not_signed detail: signature_not_signed Unknown document: summary: Kein solches Dokument in diesem Schritt value: code: signature_not_found detail: signature_not_found '409': description: >- Die gespeicherte Datei stimmt nicht mehr mit ihrem erfassten SHA-256 überein. Es wird nichts zurückgegeben. content: application/json: schema: type: object properties: detail: type: string code: type: string examples: Changed file: summary: Gespeicherte Datei stimmt nicht mit ihrem Hash überein value: code: signature_document_changed detail: signature_document_changed security: - ApiKeyAuth: [] x-codeSamples: - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() content = client.sessions.signatures.download_document( "11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555", ) with open("download.pdf", "wb") as file: file.write(content) - lang: javascript label: Node.js source: >- import { writeFile } from "node:fs/promises"; import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const content = await didit.sessions.signatures.downloadDocument( "11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555", ); await writeFile("download.pdf", Buffer.from(await content.arrayBuffer())); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresp, err := client.Sessions.Signatures.DownloadDocument(ctx, \"11111111-2222-3333-4444-555555555555\", \"feature_signature\", \"11111111-2222-3333-4444-555555555555\")\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer resp.Body.Close()\nfile, err := os.Create(\"download.pdf\")\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer file.Close()\nif _, err := io.Copy(file, resp.Body); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: >- import java.nio.file.Path; import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); client.sessions().signatures().downloadDocument("11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555") .writeTo(Path.of("download.pdf")); - lang: php label: PHP source: >- sessions->signatures->downloadDocument('11111111-2222-3333-4444-555555555555', 'feature_signature', '11111111-2222-3333-4444-555555555555'); $content->saveTo('download.pdf'); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new content = didit.sessions.signatures.download_document( "11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555" ) File.binwrite("download.pdf", content) - lang: csharp label: .NET source: >- using System; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var content = await client.Sessions.Signatures.DownloadDocumentAsync("11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555"); await content.SaveToAsync("download.pdf"); 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.