Retrieve multiple parcel documents
Parcel documents
Retrieve multiple parcel documents
Download multiple parcel documents of the same type in bulk.
GET
Retrieve multiple parcel documents
Sendcloud generates the correct type of document for your shipment when you Create a parcel, provided that you have filled in all the information related to the parcel contents, value and invoice. Use this endpoint to retrieve these documents in bulk.
This endpoint supports the following document types:
labelcustoms-declarationair-waybill
For international shipments, customs declaration must be attached (either physically or digitally for some carriers) to the shipment for customs officials to access.
proof-of-delivery is not available on this bulk endpoint. Unlike the other document types, which are generated and stored by Sendcloud, proof of delivery is fetched with a live call to the carrier for each individual parcel, so it cannot be retrieved in bulk. Use Retrieve a parcel document to request proof of delivery for a single parcel.Authorizations
Basic Authentication using API key and secrets is currently the main authentication mechanism.
Path Parameters
Document type you want to retrieve.
Available options:
label, customs-declaration, air-waybill Example:
"customs-declaration"
Query Parameters
Parcels for which you want to retrieve the documents
Required array length:
1 - 20 elementsExample:
[1, 2, 3]The paper size of the document you would like to retrieve. Paper size can be one of:
- A4
- A5
- A6
Omitting this query parameter leads to the internal paper size of the document being used. Generally this is A6 for labels and A4 for larger documents, like customs documents.
Available options:
A4, A5, A6 Example:
"A4"
Response
Requested parcel document files of a specific type.
The response is of type file.