---
title: "Generate the PDF report of an analysis (binary)"
method: POST
path: "/api/v1/generate-pdf"
tags: ["Nodes"]
---

# Generate the PDF report of an analysis (binary)

`POST /api/v1/generate-pdf`

## Request

- Base URL: `https://legal.nexusquantum.legal`
- URL: `https://legal.nexusquantum.legal/api/v1/generate-pdf`
- Auth: HTTP bearer

Generates the PDF report from client-supplied `analysisText`. Wraps /api/generate-pdf. Returns `application/pdf` (body-stream passthrough) or `409 DOSSIER_NOT_CERTIFIABLE` (signable Final Version with broken citations, with refund). `jurisdiction` OPTIONAL (no default). Scope `mcp`/`*`. The internal route debits 1 cr with refund; the v1 layer does not debit.

## Request body

- object
  - `analysisText` string, required
  - `confidenceScore` number
  - `filename` string
  - `locale` string
  - `signatureMode` 'none' | 'system' | 'client'
  - `exportProfile` 'completa' | 'ejecutiva' | 'tribunal' | 'riesgos': PDF layout profile. Spanish-language IDENTIFIERS, sent verbatim: `completa` (full report), `ejecutiva` (executive summary), `tribunal` (court-ready), `riesgos` (risks only).
  - `outputId` string
  - `jurisdiction` string: Optional ISO2 (no default).
  - `referenceDate` string

## Response `200`

PDF report.

## Other responses

- `400`: VALIDATION_ERROR — `analysisText` is empty.
- `402`: INSUFFICIENT_CREDITS | SPEND_CAP_REACHED
- `403`: MCP_SCOPE_REQUIRED
- `409`: DOSSIER_NOT_CERTIFIABLE — Final Version with broken citations (internal JSON relayed) | BYO_PROVIDER_REQUIRED — BYO-enforced account with no enabled BYO configuration (fail-closed, with refund; ConflictError envelope).

---

[API](https://skmtc.dev/nexusquantum/apis/nexus-legal-api.md) · [All operations](https://skmtc.dev/nexusquantum/apis/nexus-legal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nexusquantum/apis/nexus-legal-api/revisions/4084d8d4eb0b?raw)