Purchase label

This is a 2nd step of the label purchase flow where we first create a shipment object (and get rates for a given shipment). Then, we purchase a label for the provided ‘rate’.

HTTP Method

POST

URL

Copy

Copied

https://api.goshippo.com/transactions/

Purchase from created Shipment

This is a flow where we first create a shipment object (and get rates for a given shipment). Then, we purchase a label for the provided rate.

Request Payload

Parameter	Description
rate*	`object_id` of the rate object we get in the create shipments call response.
label_file_type*	Allowed values: `PDF`, `PDF_A4`
async	Set to true if you want to poll for the result and receive faster response

Copy

Copied

Note: Parameters with an * are mandatory

Example

Request Sample

Copy

Copied

curl --location --request POST 'https://api.goshippo.com/transactions' \
--header 'Authorization: ShippoToken shippo_live_***’ \
--header 'Content-Type: application/json' \
--data-raw '{
    "rate": "32444e5afe5c4d5fa44de02e4b56870d",
    "async": false,
    "label_file_type": "PDF"
}'

Response Sample

Copy

Copied

{
   "object_state": "VALID",
   "status": "SUCCESS",
   "object_created": “2025-08-05T21:43:41.829Z”,
   "object_updated":“2025-08-05T21:43:41.829Z”,
   "object_id": "cbc1a12243db44b9ae56ef3ca502b8c3",
   "object_owner": expn-prod-test@goshippo.com",
   "test": false,
   "rate": "32444e5afe5c4d5fa44de02e4b56870d",
   "tracking_number": "TQ966044837GB",
   "tracking_status": "PRE_TRANSIT",
   "eta": null,
   "tracking_url_provider": "",
   "label_url": "you_will_find_your_label_url_here",
   "commercial_invoice_url": null,
   "messages": [],
   "order": null,
   "metadata": "",
   "parcel": "bf276a9f955f43e7b7a75345687b9f4d",
   "billing": {
       "payments": []
   },
   "qr_code_url": null
}

Sample Label

Below is a sample PDF label for a Royal Mail C2C MCA Tracked 48 for Post Office Drop.

After you have created your label and shipped your package, you may request tracking status updates by following the process described in Step 4: Track.