POST
/
labels
Create Label
curl --request POST \
  --url https://api.loopreturns.com/api/v1/labels \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "label_request_id": "67329889100573",
  "tracking_number": "9400136105440512280610",
  "carrier": "usps",
  "label_url": "https://s3.amazonaws.com/example-bucket/label.pdf",
  "qrcode_url": "https://s3.amazonaws.com/example-bucket/qrcode.pdf",
  "rate": {
    "amount": 50000,
    "currency_code": "USD"
  }
}'
{
  "id": "67329889100573",
  "tracking_number": "9400136105440512280610",
  "carrier": "usps",
  "label_url": "https://s3.amazonaws.com/example-bucket/label.pdf",
  "qrcode_url": "https://s3.amazonaws.com/example-bucket/qrcode.pdf",
  "rate": {
    "amount": 50000,
    "currency_code": "USD"
  },
  "status": "new",
  "created_at": "2023-04-25T13:25:00-05:00"
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
label_request_id
string
required

The label request id this label applies to.

Examples:

"67329889100573"

​
tracking_number
string
required

The tracking number associated with the label.

Maximum length: 256
Examples:

"9400136105440512280610"

​
carrier
string
required

The carrier associated with the label.

Maximum length: 32
Examples:

"usps"

​
label_url
string
required

The URL containing the printable PDF of the labels.

Maximum length: 2048
Examples:

"https://s3.amazonaws.com/example-bucket/label.pdf"

​
rate
object
required
Examples:
{ "amount": 50000, "currency_code": "USD" }
{ "amount": 25000 }
{ "amount": 1500, "currency_code": "EUR" }
​
qrcode_url
string

The QR Code URL containing the printable PDF of the labels.

Maximum length: 512
Examples:

"https://s3.amazonaws.com/example-bucket/qrcode.pdf"

Response

OK

​
id
string

The id of the Label you created.

Examples:

"67329889100573"

​
tracking_number
string

The tracking number associated with the label.

Examples:

"9400136105440512280610"

​
carrier
string

The carrier associated with the label.

Examples:

"usps"

​
label_url
string

The URL containing the printable PDF of the labels.

Examples:

"https://s3.amazonaws.com/example-bucket/label.pdf"

​
qrcode_url
string

The QR Code URL containing the printable PDF of the labels.

Examples:

"https://s3.amazonaws.com/example-bucket/qrcode.pdf"

​
rate
object
Examples:
{ "amount": 50000, "currency_code": "USD" }
{ "amount": 25000 }
{ "amount": 1500, "currency_code": "EUR" }
​
status
string

The status of the label.

Examples:

"new"

​
created_at
string<date-time>

The date the label was created.

Examples:

"2023-04-25T13:25:00-05:00"