---
title: "Read generated appointment PDF"
method: GET
path: "/v1/shipper/shipment/{orderNumber}/appointment/{stop}/pdf"
tags: ["Shipper API"]
---

# Read generated appointment PDF

`GET /v1/shipper/shipment/{orderNumber}/appointment/{stop}/pdf`

## Request

- Base URL: `https://api.oway.io`
- URL: `https://api.oway.io/v1/shipper/shipment/{orderNumber}/appointment/{stop}/pdf`
- Auth: HTTP bearer and API key in header `x-oway-api-key`

Returns the generated appointment PDF snapshot for one stop. The PDF is built at carrier acceptance (cover sheet + merged supporting documents) and re-generated on subsequent shipper-driven updates. Returns 404 before generation has occurred.

## Path parameters

- `orderNumber` string, required
- `stop` 'PICKUP' | 'DELIVERY', required

## Response `200`

Returns the application/pdf bytes for this stop.

## Other responses

- `404`: PDF has not been generated for this order/stop yet (reason `appointment_pdf_not_generated`), or the order does not exist (reason `order_not_found`).

---

[API](https://skmtc.dev/shipoway/apis/oway-shipper-api.md) - [All operations](https://skmtc.dev/shipoway/apis/oway-shipper-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shipoway/apis/oway-shipper-api/revisions/35141ac5fb57?raw)