---
title: "POST /apps/pdf/v1/preview"
method: POST
path: "/apps/pdf/v1/preview"
---

# POST /apps/pdf/v1/preview

`POST /apps/pdf/v1/preview`

Generate a PDF preview of the provided GOBL document.

## Request body

- object
  - `logo_url` string, uri — URL of the logo to include in the PDF.
  - `logo_height` integer — Height of the logo in pixels.
  - `locale` string — Locale to use for the PDF generation (e.g., "es").
  - `date_format` string — Date format to use in the PDF (e.g., "%Y-%m-%d"). Keys: `%Y` = full year, `%m` = month, `%d` = day.
  - `hide_promo` boolean — Whether to hide the Invopop footer.
  - `layout` 'A4' | 'Letter' | 'DIN5008' — Layout to use for the PDF (e.g., "Letter").
  - `data` object — The complete GOBL **Envelope** to convert.

## Response `200`

Successfully generated PDF preview.

## Other responses

- `400` — Bad Request - Invalid input data.
- `500` — Internal Server Error - Failed to generate PDF.

---

[API](https://skmtc.net/invopop/apis/access-service-api.md) · [All operations](https://skmtc.net/invopop/apis/access-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/invopop/access-service-api/versions/fc954f96ea62/schema)