---
title: "Request an async PDF print of an applicant"
method: POST
path: "/api/v2/applicants/{applicant_id}/print"
tags: ["Applicants"]
---

# Request an async PDF print of an applicant

`POST /api/v2/applicants/{applicant_id}/print`

Enqueues a background job to generate a PDF of the applicant and returns a pollable download URL. The PDF is generated asynchronously; clients should poll the returned print_url until it returns 200. Optionally restrict the PDF to specific stages via stage_external_ids; when omitted, every stage the applicant has landed in is included.

## Request body

- object
  - `stage_external_ids` string[] — External IDs of the stages to include in the PDF. Defaults to all landed stages when omitted.

## Response `202`

Print request accepted and job enqueued

- object
  - `request_id` string, required — Opaque identifier for polling the print request
  - `print_url` string, uri, required — URL clients should poll for the PDF
  - `status` 'pending' | 'completed' | 'failed', required — Current status of the request
  - `created_at` string, date-time, required — When the request was created

## Other responses

- `401` — Unauthorized
- `404` — Applicant not found

---

[API](https://skmtc.net/fountain/apis/hire-public-api.md) · [All operations](https://skmtc.net/fountain/apis/hire-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fountain/hire-public-api/revisions/5f406c0e9462/schema)