> ## 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. # Report PDF delle transazioni API > Scarica con Didit una transazione monitorata come report PDF con esito, parti, alert, esecuzioni delle regole, risultati di screening e transazioni correlate. Prompt API per generare il report PDF della transazione Copia il prompt negli appunti \

\`Download one Didit monitored transaction as a PDF report through the Management API.

Endpoint:
GET https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/transactions/{transaction_uuid}/pdf/

Authentication:
Use the x-api-key header with my Didit API key. A scoped key needs media: read and transactions: read, because a PDF report counts as media. Keys limited to specific workflows or to approved sessions cannot call this endpoint.

Goal:
\- Get a PDF of a transaction for an audit file, a handoff to another team, or a regulator request.

Path parameters:
\- organization_id: my organization UUID.
\- application_id: the UUID of the application my API key belongs to. Any other application returns 403.
\- transaction_uuid: the Didit transaction uuid, not my own txn_id.

Behavior:
\- The response body is the PDF itself (Content-Type: application/pdf). Do not parse it as JSON.
\- Content-Disposition is always attachment; filename=transaction_{transaction_uuid}.pdf.
\- The report covers the overview and verdict, parties and payment methods, custom properties, alerts and rule runs, screening and Travel Rule results, the network summary, the cost breakdown, up to 50 related transactions and the 20 most recent activity entries.
\- It is rendered from the transaction's current data on every call. Nothing is stored and nothing is billed. Rendering can take a few seconds, so use a generous client timeout.

Example call:
curl -X GET "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/transactions/{transaction_uuid}/pdf/" \
-H "x-api-key: YOUR_API_KEY" \
-o transaction_report.pdf

Failure modes (JSON bodies):
\- 401: the API key has expired.
\- 403: missing API key (a wrong, revoked or expired key gets 401) ({"detail": "Authentication credentials were not provided or are invalid."}), an application_id that is not my key's application ({"detail": "You do not have permission to perform this action."}), a scoped key without media: read ({"detail": "This API key has no read access to media."}) or transactions: read, a key with workflow or status limits, or a request from outside the key's IP allowlist.
\- 404: no transaction with this uuid in my application ({"detail": "No Transaction matches the given query."}).
\- 429: more than 600 GET requests per minute with this key; wait Retry-After seconds and retry.

Side effects: none.

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

\
Incolla in Il report viene generato su richiesta a partire dai dati correnti della transazione, quindi chiamalo di nuovo dopo un cambio di stato per ottenere una copia aggiornata. A differenza degli altri endpoint delle transazioni, questo si trova su un percorso con ambito a livello di applicazione: inserisci nell'URL l'ID della tua organizzazione e l'ID dell'applicazione a cui appartiene la tua chiave API. Vedi [Trova l'ID della tua organizzazione](https://docs.didit.me/it/getting-started/api-authentication.md#trovare-il-tuo-id-organizzazione).> [!NOTE] > > Un report PDF viene considerato un contenuto multimediale. Una [chiave API con ambito limitato](https://docs.didit.me/it/console/api-keys.md) richiede **media: read** oltre a **transactions: read**, e una chiave senza accesso ai media riceve `403` anche quando può leggere la transazione in formato JSON con [Ottieni transazione](https://docs.didit.me/it/management-api/transactions/get.md). ## OpenAPI ````yaml it/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/transactions/{transaction_uuid}/pdf/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/transactions/{transaction_uuid}/pdf/: get: tags: - Transactions summary: Scarica un report PDF della transazione description: >- Genera un report PDF per una transazione monitorata: panoramica e verdetto, parti e metodi di pagamento, proprietà personalizzate, alert ed esecuzioni delle regole, risultati dello screening e della Travel Rule, riepilogo della rete, dettaglio dei costi, fino a 50 transazioni correlate e le 20 voci di attività più recenti. Il corpo della risposta è il PDF stesso (`application/pdf`), non JSON. Il report viene generato a partire dai dati correnti della transazione a ogni chiamata, quindi richiedilo nuovamente dopo una modifica di stato. Non viene memorizzato nulla e non viene addebitato alcun costo. La generazione può richiedere alcuni secondi, quindi usa un timeout del client generoso. Questo endpoint risiede su un percorso con ambito applicazione: inserisci nell'URL l'ID della tua organizzazione e l'ID dell'applicazione a cui appartiene la tua chiave API ([trova l'ID della tua organizzazione](https://docs.didit.me/it/getting-started/api-authentication#trovare-il-tuo-id-organizzazione)). Un report PDF è considerato un contenuto multimediale: una chiave API con ambito limitato deve avere le autorizzazioni `media: read` e `transactions: read`, e una chiave limitata ad alcuni workflow o a sessioni approvate non può chiamarlo. operationId: get_transaction_pdf parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID dell'organizzazione. example: 11111111-2222-3333-4444-555555555555 - name: application_id in: path required: true schema: type: string format: uuid description: >- UUID dell'applicazione. Deve essere l'applicazione a cui appartiene la chiave API: una chiave utilizzata su qualsiasi altra applicazione riceve `403`. example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee - name: transaction_uuid in: path required: true description: >- UUID della transazione Didit: l'`uuid` restituito da `POST /v3/transactions/` e `GET /v3/transactions/`. Il tuo `txn_id` personale non è accettato. schema: type: string format: uuid example: abcdef12-3456-7890-abcd-ef1234567890 responses: '200': description: >- Il PDF renderizzato, restituito direttamente come binario `application/pdf`. headers: Content-Disposition: description: >- Sempre `attachment; filename=transaction_{transaction_uuid}.pdf`. schema: type: string example: >- attachment; filename=transaction_abcdef12-3456-7890-abcd-ef1234567890.pdf content: application/pdf: schema: type: string format: binary '401': description: >- La chiave API è scaduta. Solo una chiave creata con una data di scadenza può scadere; dopo tale data ogni richiesta inviata con essa risponde con `401`. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- La richiesta non è consentita. Consulta `detail`: chiave API mancante (una chiave errata, revocata o scaduta restituisce `401`), un `application_id` diverso dall'applicazione della chiave, una chiave con ambito senza `media: read` o `transactions: read`, una chiave limitata a workflow o sessioni approvate, oppure una richiesta proveniente dall'esterno dell'elenco IP della chiave. content: application/json: schema: type: object properties: detail: type: string examples: Missing or invalid key: value: detail: >- Authentication credentials were not provided or are invalid. Another application: value: detail: You do not have permission to perform this action. Scoped key without media read: value: detail: This API key has no read access to media. Scoped key without transactions read: value: detail: This API key has no read access to transactions. Key limited to workflows or approved sessions: value: detail: >- This API key only reaches sessions inside its workflow or status limits, so it can't use this endpoint. Outside the key's IP list: value: detail: This API key can't be used from this IP address. '404': description: >- Nessuna transazione con questo UUID esiste nell'applicazione (mai creata, eliminata o di proprietà di un'altra applicazione). Un `transaction_uuid` che non è un UUID non raggiunge l'API: restituisce una pagina HTML `404` invece di questo corpo JSON. content: application/json: schema: type: object properties: detail: type: string examples: Not found: value: detail: No Transaction matches the given query. '429': description: >- Più di 600 richieste GET al minuto con questa chiave API. Attendi il numero di secondi indicato in `Retry-After`, quindi riprova. content: application/json: schema: type: object properties: detail: type: string examples: Throttled: value: detail: >- GET request rate limit exceeded. You can make up to 600 requests per minute. headers: Retry-After: description: >- Secondi fino al ripristino della finestra temporale corrente di un minuto. schema: type: integer example: 23 X-RateLimit-Limit: description: Richieste consentite al minuto per questo budget. schema: type: integer X-RateLimit-Remaining: description: Richieste rimanenti nell'intervallo corrente. schema: type: integer X-RateLimit-Reset: description: Ora Unix in cui la finestra si azzera. schema: type: integer security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl --fail -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/transactions/abcdef12-3456-7890-abcd-ef1234567890/pdf/' \ -H 'x-api-key: YOUR_API_KEY' \ --output transaction_report.pdf - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() content = client.transactions.generate_pdf( "abcdef12-3456-7890-abcd-ef1234567890", ) 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, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. const didit = new Didit(); const content = await didit.transactions.generatePdf("abcdef12-3456-7890-abcd-ef1234567890"); await writeFile("download.pdf", Buffer.from(await content.arrayBuffer())); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresp, err := client.Transactions.GeneratePDF(ctx, \"abcdef12-3456-7890-abcd-ef1234567890\")\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_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); client.transactions().generatePdf("abcdef12-3456-7890-abcd-ef1234567890") .writeTo(Path.of("download.pdf")); - lang: php label: PHP source: >- transactions->generatePdf('abcdef12-3456-7890-abcd-ef1234567890'); $content->saveTo('download.pdf'); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new content = didit.transactions.generate_pdf("abcdef12-3456-7890-abcd-ef1234567890") File.binwrite("download.pdf", content) - 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(); var content = await client.Transactions.GeneratePdfAsync("abcdef12-3456-7890-abcd-ef1234567890"); await content.SaveToAsync("download.pdf"); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.