> ## 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 PDF da sessão KYB de empresa > Baixe o PDF de uma sessão KYB concluída na Didit: dados do registro, pessoas-chave, proprietários, documentos, AML e revisões. Prompt da API para gerar o PDF da sessão de empresa Copiar o prompt para a área de transferência \

\`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.`

\
Colar em [Gerar PDF](https://docs.didit.me/pt-br/sessions-api/generate-pdf.md) também gera relatórios de KYB. Use o que melhor se adequar à sua integração: este endpoint identifica a sessão pela sua organização e aplicação, e o outro apenas pelo ID da sessão.> [!NOTE] > > O relatório só fica disponível quando a sessão está `Approved`, `Declined` ou `In Review`. Aguarde o [webhook](https://docs.didit.me/pt-br/integration/webhooks.md) `status.updated` antes de solicitá-lo.## Conteúdos relacionados- [Gerar PDF](https://docs.didit.me/pt-br/sessions-api/generate-pdf.md) - [Exportar para PDF e CSV](https://docs.didit.me/pt-br/console/export-pdf-csv.md) - [Esquema de resposta de KYB](https://docs.didit.me/pt-br/business-verification/response-schema.md) ## OpenAPI ````yaml pt-br/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 verificação de identidade. Autentique-se com o cabeçalho 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: Baixar o relatório em PDF de uma sessão de empresa description: >- Gera o relatório em PDF de uma sessão de Verificação de empresas (KYB): dados do registro de empresas, pessoas-chave e beneficiários finais, documentos, resultados de AML e os demais recursos do fluxo, além das tags e da atividade de revisão da sessão. Com a personalização de marca própria ativada, o relatório traz o seu logotipo e a URL da sua política de privacidade. O corpo da resposta é o próprio PDF (`application/pdf`), não JSON. A sessão precisa estar com status `Approved`, `Declined` ou `In Review`; qualquer outro status retorna `403`, então aguarde primeiro o [webhook](https://docs.didit.me/pt-br/integration/webhooks) `status.updated`. O relatório é gerado a cada chamada e nada é cobrado, então armazene o arquivo em vez de buscá-lo repetidamente. `GET /v3/session/{sessionId}/generate-pdf/` gera o mesmo tipo de relatório apenas com o ID da sessão. Um relatório em PDF conta como mídia: uma chave de API com escopo precisa de `businesses: read` e `media: read`, e uma chave limitada a alguns fluxos ou a sessões aprovadas não pode chamá-lo. operationId: get_business_session_pdf parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID da organização. example: 11111111-2222-3333-4444-555555555555 - name: application_id in: path required: true schema: type: string format: uuid description: >- UUID da aplicação. Deve ser a aplicação à qual a chave de API pertence: uma chave usada em qualquer outra aplicação recebe `403`. example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee - name: business_session_id in: path required: true description: >- `session_id` da sessão de Verificação de empresas (KYB), conforme retornado na criação da sessão. Uma sessão de outra aplicação retorna `404`. schema: type: string format: uuid example: 22222222-3333-4444-5555-666666666666 responses: '200': description: >- O PDF renderizado, retornado diretamente como binário `application/pdf`. headers: Content-Disposition: description: >- Sempre `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: >- A chave de API expirou. Somente uma chave criada com data de validade pode expirar; após essa data, toda requisição feita com ela responde `401`. content: application/json: schema: type: object properties: detail: type: string examples: Expired key: value: detail: This API key has expired. '403': description: >- A requisição não é permitida ou a sessão não foi concluída. Leia `detail`: uma sessão que não está `Approved`, `Declined` ou `In Review`, uma chave de API ausente (uma chave incorreta, revogada ou expirada recebe `401`), um `application_id` que não é da aplicação da chave, uma chave com escopo sem `media: read` ou `businesses: read`, uma chave limitada a fluxos ou a sessões aprovadas, ou uma requisição de fora da lista de IPs da chave. 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: >- Não existe nenhuma sessão de empresa com este ID na aplicação (nunca foi criada, foi excluída ou pertence a outra aplicação). Um valor que não seja um UUID retorna uma página HTML `404` em vez deste corpo JSON. content: application/json: schema: type: object properties: detail: type: string examples: Not found: value: detail: Business session not found. '429': description: >- Mais de 600 requisições GET por minuto com esta chave de API. Aguarde o número de segundos indicado em `Retry-After` e tente novamente. 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 até a janela atual de um minuto ser reiniciada. schema: type: integer example: 23 X-RateLimit-Limit: description: Requisições permitidas por minuto nesta cota. schema: type: integer X-RateLimit-Remaining: description: Requisições restantes na janela atual. schema: type: integer X-RateLimit-Reset: description: Horário Unix em que a janela é reiniciada. 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: >- Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.