Skip to main content
GET
/
client
/
label
/
{id}
Get label
curl --request GET \
  --url https://api.ship.uniuni.com/prod/client/label/{id} \
  --header 'Authorization: Bearer <token>'
{
  "message": "Success",
  "code": 0,
  "data": {
    "headers": {
      "Content-Type": "application/pdf",
      "Content-Disposition": "attachment; filename=\"UR07240000000004901_shipping_labels_2025-07-31.pdf\""
    },
    "body": "JVBERi0xLjMKJf////8K..."
  }
}
When labelType is shipping, the shipment must have been purchased first.
The PDF content is Base64-encoded in the body field. To save it as a file: 
const fs = require('fs');
const pdfBuffer = Buffer.from(response.data.body, 'base64');
fs.writeFileSync('label.pdf', pdfBuffer);

Authorizations

​
Authorization
string
header
required

API access token generated from the UniUni Platform dashboard.

Path Parameters

​
id
string
required

The orderNumber (for shipping labels) or batchNumber (for batch labels).

Query Parameters

​
labelType
enum<string>
required

Type of label to retrieve.

Available options:
shipping,
batching

Response

200 - application/json

Label PDF or error

​
message
string
required

Additional information about the request status.

​
code
integer
required

Status code. 0 indicates success.

​
data
any

Response payload. Returns null if code is not 0.