---
title: "Retrieve packing slip"
description: "Whether a packing slip PDF is stored for an invoice, and a one-week signed URL to it when it is. A packing slip is the invoice rendered through a packing-slip template; it exists only after it was printed or downloaded o"
url: https://docs.invoicefalcon.com/v3-reference/documents/retrieve-packing-slip/
api: "API v3 reference"
method: GET
path: "/documents/packing_slips/{invoice_id}"
---

# Retrieve packing slip

`GET https://app.invoicefalcon.com/api/v3/external/documents/packing_slips/{invoice_id}`

Whether a packing slip PDF is stored for an invoice, and a one-week signed URL to it when it is. A packing slip is the invoice rendered through a packing-slip template; it exists only after it was printed or downloaded once. Read-only: it never renders the PDF.

## Path parameters

- `invoice_id` (string, required)

## Returns

- `invoice_id` (integer): e.g. `980191049`
- `invoice_number` (string): e.g. `INV-42`
- `order` (object)
  - `shopify_order_id` (string): e.g. `gid://shopify/Order/42`
  - `name` (string): e.g. `#1042`
  - `number` (integer, nullable)
- `pdf` (object)
  - `available` (boolean): e.g. `false`
  - `filename` (string, nullable)
  - `url` (string, nullable)
  - `generated_at` (string, nullable)

Rate limit: this call costs 1 point ([rate limits](https://docs.invoicefalcon.com/v3/docs/api-v3/rate-limits/)).

## Example request

```sh
curl "https://app.invoicefalcon.com/api/v3/external/documents/packing_slips/{invoice_id}" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
```

## 200

The requested resource.

```json
{
  "invoice_id": 980191049,
  "invoice_number": "INV-42",
  "order": {
    "shopify_order_id": "gid://shopify/Order/42",
    "name": "#1042",
    "number": null
  },
  "pdf": {
    "available": false,
    "filename": null,
    "url": null,
    "generated_at": null
  }
}
```

## 401

Missing or unknown `X-Auth-Token`, or the shop uninstalled the app.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "unauthorized"
}
```

## 403

`v3_required`: the shop still runs the previous dashboard. `paid_plan_required`: API access needs a paid plan.

```json
{
  "errors": [
    "API access requires a paid plan"
  ],
  "code": "paid_plan_required"
}
```

## 404

The resource does not exist for this shop, or no action is registered at this path.

```json
{
  "errors": [
    "Resource not found"
  ],
  "code": "not_found"
}
```

## 422

The request failed validation. Nothing was saved.

```json
{
  "errors": [
    "id is missing"
  ]
}
```

## 429

Rate limited: cost-weighted per key (reads cost less than writes). Wait `Retry-After` seconds; see `X-RateLimit-*` headers.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited"
}
```

