---
title: "Trigger PDF generation"
method: POST
path: "/pdf/trigger"
tags: ["Utilities"]
---

# Trigger PDF generation

`POST /pdf/trigger`

## Request

- Base URL: `https://api-sandbox.aiprise.com/api/v1`
- URL: `https://api-sandbox.aiprise.com/api/v1/pdf/trigger`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/aiprise/apis/aiprise-apis/docs/pdf/trigger/post.ts> (a function with typed inputs; its response is checked against the schema)

Triggers asynchronous PDF generation for a verification session or profile. Returns a job ID that can be used to poll for status and download the PDF when ready.

## Request body

- union
  - object
    - `session_id` string, required: Verification session ID to generate PDF for. Mutually exclusive with profile_id.
    - `profile_id` string: User or business profile ID to generate PDF for. Mutually exclusive with session_id.
  - object
    - `session_id` string: Verification session ID to generate PDF for. Mutually exclusive with profile_id.
    - `profile_id` string, required: User or business profile ID to generate PDF for. Mutually exclusive with session_id.

## Response `202`

PDF generation job created

- PdfJobPendingResponse
  - `job_id` string
  - `status` 'PENDING' | 'PROCESSING'
  - `created_at` integer: Unix timestamp in milliseconds

## Other responses

- `400`: Bad Request
- `403`: Forbidden - session or profile not found or access denied

---

[API](https://skmtc.dev/aiprise/apis/aiprise-apis.md) - [All operations](https://skmtc.dev/aiprise/apis/aiprise-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/aiprise/apis/aiprise-apis/revisions/74fc7a5199fb?raw)