> ## 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. # API de informe PDF de sesión KYB de empresa > Descarga con Didit el PDF de una sesión KYB finalizada: datos de registro, personas clave, propietarios, documentos, AML y revisiones. Prompt de la API para generar el PDF de una sesión de empresa Copiar el prompt al portapapeles \

\`Download the PDF report of one finished Didit business verification (KYB) session.

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

Authentication:
Use the x-api-key header with my Didit API key. A scoped key needs businesses: read and media: read; a key limited to some workflows or to approved sessions can't call this endpoint. application_id must be the application the key belongs to.

Goal:
\- Store an audit-ready KYB report for my compliance archive, or attach it to a case or regulator request.

Behavior:
\- business_session_id is the session_id of the KYB session.
\- The session must be "Approved", "Declined" or "In Review"; any other status returns 403.
\- The body is binary application/pdf, not JSON. Content-Disposition: attachment; filename=business_.pdf.
\- The report covers company registry data, key people and beneficial owners, documents, AML results and the other workflow features, plus the session's tags and reviews. With white-label customization on, it uses my logo and privacy policy URL.
\- Rendered on every call: store the file instead of fetching it repeatedly.

Example call:
curl --fail -X GET "https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/businesses/c2d3e4f5-0617-4829-9a3b-4c5d6e7f8091/pdf/" \
-H "x-api-key: YOUR_API_KEY" \
\--output business-report.pdf

What to read from the response:
\- The PDF bytes. Do not parse the body as JSON.
\- Content-Disposition - the suggested file name.

Failure modes:
\- 401 - the API key has expired.
\- 403 - {"detail": "You can only generate a PDF for sessions in review, declined or approved."} when the session is not finished; {"detail": "Authentication credentials were not provided or are invalid."} for a missing key (a wrong, revoked or expired key gets 401); {"detail": "You do not have permission to perform this action."} for a key of another application; a scoped key without businesses: read or media: read; a key limited to workflows or approved sessions; a request from outside the key's IP list.
\- 404 - {"detail": "Business session not found."}
\- 429 - more than 600 GET requests per minute with this key.

Side effects: none. Not billed.

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

\
Pegar en [Generar PDF](https://docs.didit.me/es/sessions-api/generate-pdf.md) también genera informes KYB. Usa el que mejor se adapte a tu integración: este endpoint identifica la sesión a través de tu organización y tu aplicación, y el otro solo por el ID de sesión.> [!NOTE] > > El informe solo está disponible cuando la sesión está en estado `Approved`, `Declined` o `In Review`. Espera a recibir el [webhook](https://docs.didit.me/es/integration/webhooks.md) `status.updated` antes de solicitarlo.## Contenido relacionado- [Generar PDF](https://docs.didit.me/es/sessions-api/generate-pdf.md) - [Exportar a PDF y CSV](https://docs.didit.me/es/console/export-pdf-csv.md) - [Esquema de respuesta KYB](https://docs.didit.me/es/business-verification/response-schema.md) ## OpenAPI ````yaml es/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/businesses/{business_session_id}/pdf/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificación de identidad. Autentícate con el encabezado x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/businesses/{business_session_id}/pdf/: get: tags: - Businesses summary: Descargar el informe PDF de una sesión de empresa description: >- Genera el informe PDF de una sesión de Verificación de empresas (KYB): datos del registro de empresas, personas clave y beneficiarios finales, documentos, resultados AML y las demás funciones del flujo de verificación (workflow), además de las etiquetas y la actividad de revisión de la sesión. Con la personalización de marca blanca activada, el informe incluye tu logotipo y la URL de tu política de privacidad. El cuerpo es el propio PDF (`application/pdf`), no JSON. La sesión debe estar en `Approved`, `Declined` o `In Review`; cualquier otro estado devuelve `403`, así que espera primero al [webhook](https://docs.didit.me/es/integration/webhooks) `status.updated`. El informe se genera en cada llamada y no se factura nada, así que guarda el archivo en lugar de obtenerlo repetidamente. `GET /v3/session/{sessionId}/generate-pdf/` genera el mismo tipo de informe solo con el ID de la sesión. Un informe PDF cuenta como contenido multimedia: una clave de API con alcance limitado necesita `businesses: read` y `media: read`, y una clave limitada a algunos flujos o a sesiones aprobadas no puede llamarlo. operationId: get_business_session_pdf parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID de la organización. example: 11111111-2222-3333-4444-555555555555 - name: application_id in: path required: true schema: type: string format: uuid description: >- UUID de la aplicación. Debe ser la aplicación a la que pertenece la clave de API: una clave usada en cualquier otra aplicación recibe `403`. example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee - name: business_session_id in: path required: true description: >- `session_id` de la sesión de verificación de empresas (KYB), tal como se devolvió al crear la sesión. Una sesión de otra aplicación devuelve `404`. schema: type: string format: uuid example: 22222222-3333-4444-5555-666666666666 responses: '200': description: >- El PDF generado, devuelto directamente como binario `application/pdf`. headers: Content-Disposition: description: >- Siempre `attachment; filename=business_{business_session_id}.pdf`. schema: type: string example: >- attachment; filename=business_22222222-3333-4444-5555-666666666666.pdf content: application/pdf: schema: type: string format: binary '401': description: >- La clave de API ha expirado. Solo puede expirar una clave creada con fecha de caducidad; a partir de esa fecha, toda solicitud que la use responde `401`. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- La solicitud no está permitida o la sesión no ha terminado. Lee `detail`: una sesión que no está en `Approved`, `Declined` o `In Review`, falta la clave de API (una clave incorrecta, revocada o expirada recibe `401`), un `application_id` que no es la aplicación de la clave, una clave con alcance limitado sin `media: read` o `businesses: read`, una clave limitada a flujos o a sesiones aprobadas, o una solicitud desde fuera de la lista de IP de la clave. content: application/json: schema: type: object properties: detail: type: string examples: Session not finished: value: detail: >- You can only generate a PDF for sessions in review, declined or approved. 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 businesses read: value: detail: This API key has no read access to companies. 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: >- No existe ninguna sesión de empresa con este ID en la aplicación (nunca se creó, se eliminó o pertenece a otra aplicación). Un valor que no es un UUID devuelve una página HTML `404` en lugar de este cuerpo JSON. content: application/json: schema: type: object properties: detail: type: string examples: Not found: value: detail: Business session not found. '429': description: >- Más de 600 solicitudes GET por minuto con esta clave de API. Espera el número de segundos indicado en `Retry-After` y vuelve a intentarlo. 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: Segundos hasta que se reinicia la ventana actual de un minuto. schema: type: integer example: 23 X-RateLimit-Limit: description: Solicitudes permitidas por minuto en este presupuesto. schema: type: integer X-RateLimit-Remaining: description: Solicitudes restantes en la ventana actual. schema: type: integer X-RateLimit-Reset: description: Tiempo Unix en que se restablece la ventana. 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/businesses/22222222-3333-4444-5555-666666666666/pdf/' \ -H 'x-api-key: YOUR_API_KEY' \ --output business_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.businesses.generate_session_pdf( "22222222-3333-4444-5555-666666666666", ) 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.businesses.generateSessionPdf("22222222-3333-4444-5555-666666666666"); 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.Businesses.GenerateSessionPDF(ctx, \"22222222-3333-4444-5555-666666666666\")\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.businesses().generateSessionPdf("22222222-3333-4444-5555-666666666666") .writeTo(Path.of("download.pdf")); - lang: php label: PHP source: >- businesses->generateSessionPdf('22222222-3333-4444-5555-666666666666'); $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.businesses.generate_session_pdf("22222222-3333-4444-5555-666666666666") 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.Businesses.GenerateSessionPdfAsync("22222222-3333-4444-5555-666666666666"); await content.SaveToAsync("download.pdf"); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.