Skip to main content
POST
/
box
/
finalize
Finalize a Deutsche Post order
curl --request POST \
  --url https://panel.sendcloud.sc/api/v2/box/finalize \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "copy_count": 1
}
'
{
  "copy_count": 10
}

Documentation Index

Fetch the complete documentation index at: https://sendcloud.dev/llms.txt

Use this file to discover all available pages before exploring further.

API v2 is entering maintenance mode. New users should start with API v3 to access our latest features and improved performance. Already using v2? Don’t worry, your current integration remains fully functional. Read more about maintenance mode, or check out the migration guide for API v3.
This endpoint closes the current open order/box and generates an AWB (Air Waybill) document for all parcels in that box. How it works:
  1. As you create Deutsche Post International parcels, they are automatically added to the current box (identified by the current box_number).
  2. When the box is full or you’re ready to ship, call this endpoint to finalize the box.
  3. The finalization process generates a single AWB label that is shared by all parcels in the finalized box and increments the box_number, automatically starting a new box for subsequent parcels.
  4. You can create and finalize multiple boxes throughout the day as needed.
Parameters:
  • copy_count: Specify how many AWB copies you need (1-99). Use this if the parcels are split over multiple physical boxes or pallets.
Response: When the request is successful, a 200 code will be returned with the copy_count requested. The AWB is generated and you can retrieve the AWB label from any parcel that was in the finalized box, as the AWB label is identical for all parcels included in the box.

Authorizations

​
Authorization
string
header
required

Basic Authentication using API key and secrets is currently the main authentication mechanism.

Body

application/json

Specify how many AWB copies you need

​
copy_count
integer<int64>
default:1
Required range: 1 <= x <= 99

Response

OK

Specify how many AWB copies you need

​
copy_count
integer<int64>
default:1
Required range: 1 <= x <= 99