---
title: "Retrieve a bulk waybill"
method: GET
path: "/waybills/{id}"
tags: ["Bulk waybills"]
---

# Retrieve a bulk waybill

`GET /waybills/{id}`

Returns the details of a bulk waybill. The response includes the Base64 for the bulk waybill PDF.

## Path parameters

- `id` integer, required

## Query parameters

- `label_format` '10x19_pdf' | 'a4_pdf'

## Response `200`

Successful.

- Waybill
  - `id` integer — ID of the bulk waybill. Used when referencing a specific bulk waybill.
  - `reference` string — Carrier's reference of the bulk waybill.
  - `status` 'open' | 'closed' — Current status of the bulk waybill. If open, more shipments can be added to the bulk waybill.
  - `carrier_code` string — Carrier code, identifying which carrier the bulk waybill is created for.
  - `customer_number` string — The customer number that is attached to the bulk waybill.
  - `created_at` string, date-time — When the bulk waybill was created.
  - `sender` object — Information regarding the sender on the bulk waybill.
    - `name` string
    - `address1` string
    - `address2` string — Second address line can be used for floor/room number, building name etc.
    - `zipcode` string
    - `city` string
    - `country_code` string
  - `receiver` object — Information regarding the receiver on the bulk waybill.
    - `name` string
    - `address1` string
    - `address2` string — Second address line can be used for floor/room number, building name etc.
    - `zipcode` string
    - `city` string
    - `country_code` string
  - `loading` object — Information regarding the loading place on the bulk waybill.
    - `name` string
    - `address1` string
    - `address2` string — Second address line can be used for floor/room number, building name etc.
    - `zipcode` string
    - `city` string
    - `country_code` string
    - `date` string, date-time
  - `delivery` object — Information regarding the delivery place on the bulk waybill.
    - `name` string
    - `address1` string
    - `address2` string — Second address line can be used for floor/room number, building name etc.
    - `zipcode` string
    - `city` string
    - `country_code` string
  - `shipment` object — Shipment that contains the routing labels.
    - `id` integer
    - `label_base64` string — Base64-encoded string of the routing labels as PDF.
  - `invoice_base64` string — Base64-encoded string of invoice as PDF
  - `base64` string — Base64-encoded string of bulk waybill as PDF

## Other responses

- `401` — Unauthorized.
- `404` — Resource not found.

---

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