curl --request POST \
--url https://api-stage.orchestro.ai/e1/api/v1/core/labels \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"callerType": "SHIPPER",
"labelFormat": "PDF",
"accounts": [
{
"accountNumber": "AC0089",
"accountType": "SHIPPER"
}
],
"shipmentDate": "2024-12-22T06:34:00",
"sendTNT": true,
"sortOrder": "rate",
"currency": "USD",
"fulfillmentNode": "",
"sendAllServiceAttributes": true,
"parcels": [
{
"referenceId": "cf6fea899f1848b494d9568e8266e076",
"reference1": 123456,
"reference2": 123456,
"shipDate": "2023-12-22T06:34:00",
"serviceType": "DGRD",
"pickupType": "Pickup",
"parcelType": "P",
"shipFrom": {
"company": "ACME INC.",
"name": "ACME INC.",
"address1": "280 S YORK RD",
"address2": "",
"city": "BENSENVILLE",
"state": "IL",
"zip": "60106",
"country": "US",
"phone": "",
"email": "",
"addressType": "B"
},
"shipTo": {
"company": "Test-Company-Name",
"name": "JOSH SMITH",
"address1": "637 E WOODBRIDGE AVE",
"address2": "",
"city": "AVENEL",
"state": "NJ",
"zip": "07001",
"country": "US",
"phone": "",
"email": "",
"addressType": "B"
},
"serviceAttributes": [
"AD_SIGN"
],
"weight": {
"value": 1,
"unit": "lb"
},
"dimensions": {
"unit": "inch",
"length": 12,
"width": 12,
"height": 12
}
}
]
}
'{
"currency": "USD",
"parcels": [
{
"quoteId": "301312f9-500a-4e6a-8976-aad12db55e8c",
"referenceId": "testRefId",
"shipDate": "2024-08-22T06:34:00",
"serviceType": "GRD",
"pickupType": "Pickup",
"parcelType": "P",
"shipFrom": {
"company": "Dallas City Hall",
"name": "The City Secretary's Office",
"address1": "1500 Marilla Street",
"address2": "",
"city": "Dallas",
"state": "TX",
"zip": "75201",
"country": "US",
"phone": "",
"email": "",
"addressType": "B"
},
"shipTo": {
"company": "Municipal Building",
"name": "Brooklyn Municipal Building",
"address1": "210 Joralemon St",
"address2": "",
"city": "Brooklyn",
"state": "NY",
"zip": "11201",
"country": "US",
"phone": "212-669-8090",
"email": "",
"addressType": "B"
},
"weight": {
"unit": "lb",
"value": 6
},
"dimensions": {
"unit": "inch",
"length": 4,
"width": 4,
"height": 4
},
"rates": [
{
"zone": 6,
"serviceType": "GRD",
"tnt": "3 - 7 days",
"baseRate": 7.06,
"totalRate": 7.41,
"totalDiscount": 1.2,
"baseRateDiscount": 0,
"surcharges": [
{
"rate": 3,
"discount": 0,
"code": "Pick",
"description": "Pick Up Charges"
},
{
"rate": 0.75,
"discount": 0,
"code": "PEAK",
"description": "Carrier Peak Surcharge"
},
{
"rate": 2,
"discount": 0,
"code": "DDAS",
"description": "Delivery Area Surcharge"
},
{
"rate": 0.29,
"discount": 0,
"code": "FUEL",
"description": "Fuel Surcharge"
}
],
"serviceAttributes": [
{
"key": "POD_RQD",
"rate": 5,
"discount": 0.1,
"available": true
}
],
"destinationSortHub": "KEARNY"
}
]
}
]
}Origin Carrier
Labels
This endpoint allows users to create shipping labels by sending account information, parcel details, and shipment specifics. It returns the generated label or an error if the request fails.
POST
/
api
/
v1
/
core
/
labels
curl --request POST \
--url https://api-stage.orchestro.ai/e1/api/v1/core/labels \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"callerType": "SHIPPER",
"labelFormat": "PDF",
"accounts": [
{
"accountNumber": "AC0089",
"accountType": "SHIPPER"
}
],
"shipmentDate": "2024-12-22T06:34:00",
"sendTNT": true,
"sortOrder": "rate",
"currency": "USD",
"fulfillmentNode": "",
"sendAllServiceAttributes": true,
"parcels": [
{
"referenceId": "cf6fea899f1848b494d9568e8266e076",
"reference1": 123456,
"reference2": 123456,
"shipDate": "2023-12-22T06:34:00",
"serviceType": "DGRD",
"pickupType": "Pickup",
"parcelType": "P",
"shipFrom": {
"company": "ACME INC.",
"name": "ACME INC.",
"address1": "280 S YORK RD",
"address2": "",
"city": "BENSENVILLE",
"state": "IL",
"zip": "60106",
"country": "US",
"phone": "",
"email": "",
"addressType": "B"
},
"shipTo": {
"company": "Test-Company-Name",
"name": "JOSH SMITH",
"address1": "637 E WOODBRIDGE AVE",
"address2": "",
"city": "AVENEL",
"state": "NJ",
"zip": "07001",
"country": "US",
"phone": "",
"email": "",
"addressType": "B"
},
"serviceAttributes": [
"AD_SIGN"
],
"weight": {
"value": 1,
"unit": "lb"
},
"dimensions": {
"unit": "inch",
"length": 12,
"width": 12,
"height": 12
}
}
]
}
'{
"currency": "USD",
"parcels": [
{
"quoteId": "301312f9-500a-4e6a-8976-aad12db55e8c",
"referenceId": "testRefId",
"shipDate": "2024-08-22T06:34:00",
"serviceType": "GRD",
"pickupType": "Pickup",
"parcelType": "P",
"shipFrom": {
"company": "Dallas City Hall",
"name": "The City Secretary's Office",
"address1": "1500 Marilla Street",
"address2": "",
"city": "Dallas",
"state": "TX",
"zip": "75201",
"country": "US",
"phone": "",
"email": "",
"addressType": "B"
},
"shipTo": {
"company": "Municipal Building",
"name": "Brooklyn Municipal Building",
"address1": "210 Joralemon St",
"address2": "",
"city": "Brooklyn",
"state": "NY",
"zip": "11201",
"country": "US",
"phone": "212-669-8090",
"email": "",
"addressType": "B"
},
"weight": {
"unit": "lb",
"value": 6
},
"dimensions": {
"unit": "inch",
"length": 4,
"width": 4,
"height": 4
},
"rates": [
{
"zone": 6,
"serviceType": "GRD",
"tnt": "3 - 7 days",
"baseRate": 7.06,
"totalRate": 7.41,
"totalDiscount": 1.2,
"baseRateDiscount": 0,
"surcharges": [
{
"rate": 3,
"discount": 0,
"code": "Pick",
"description": "Pick Up Charges"
},
{
"rate": 0.75,
"discount": 0,
"code": "PEAK",
"description": "Carrier Peak Surcharge"
},
{
"rate": 2,
"discount": 0,
"code": "DDAS",
"description": "Delivery Area Surcharge"
},
{
"rate": 0.29,
"discount": 0,
"code": "FUEL",
"description": "Fuel Surcharge"
}
],
"serviceAttributes": [
{
"key": "POD_RQD",
"rate": 5,
"discount": 0.1,
"available": true
}
],
"destinationSortHub": "KEARNY"
}
]
}
]
}Authorizations
Body
application/json
This endpoint accepts a JSON request body that contains account details, caller type, currency, label format, and parcel information.
The identifier of the fulfilment node processing the shipment.
Example:
"NODE123"
A list of accounts requesting the shipping labels.
Show child attributes
Show child attributes
Example:
[
{
"accountNumber": "AC0088",
"accountType": "SHIPPER"
},
{
"accountNumber": "AC0077",
"accountType": "WMS"
}
]
The type of caller initiating the request, such as SHIPPER or WMS.
Example:
"WMS"
The currency in which the transaction is carried out.
Example:
"USD"
The format of the generated label (e.g., PDF or ZPL).
Example:
"PDF"
A list of parcels being shipped, including dimensions, references, and other parcel-specific data.
Show child attributes
Show child attributes
Whether to send all service attributes related to the shipment.
Example:
true
Whether to include TNT information for the shipment.
Example:
true
The date and time when the shipment is planned to be made, in ISO 8601 format.
Example:
"2024-12-22T06:34:00"
The order in which shipment options should be sorted.
Example:
"rate"
Response
200 - application/json
All successful Label responses
Example:
"USD"
Show child attributes
Show child attributes
Example:
[
{
"dimensions": {
"height": 4,
"length": 4,
"unit": "inch",
"width": 4
},
"labels": {
"createdDate": "2024/09/25 09:42:32",
"id": "P761NBH3",
"labelDate": "2024/09/25 09:42:32",
"labelFormat": "PNG",
"labelUrl": "https://ocn-stage-e1-files.s3.amazonaws.com/P761NBH3.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240925T094232Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Credential=AKIAXLQKESR5BTU3KJX3%2F20240925%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=7ff0d7c855edb5436d282468c40e82f075da4926b01608158e6937d475018b1f",
"sortCode": "KEARNY"
},
"parcelType": "P",
"pickupType": "Pickup",
"quoteId": "301312f9-500a-4e6a-8976-aad12db55e8c",
"reference1": "testRef1",
"reference2": "testRef2",
"referenceId": "testRefId",
"serviceType": "GRD",
"shipDate": "2024-08-22T06:34:00",
"shipFrom": {
"address1": "1500 Marilla Street",
"address2": "",
"addressType": "B",
"city": "Dallas",
"company": "Dallas City Hall",
"country": "US",
"email": "",
"name": "The City Secretary's Office",
"phone": "",
"state": "TX",
"zip": "75201"
},
"shipTo": {
"address1": "210 Joralemon St",
"address2": "",
"addressType": "B",
"city": "Brooklyn",
"company": "Municipal Building",
"country": "US",
"email": "",
"name": "Brooklyn Municipal Building",
"phone": "212-669-8090",
"state": "NY",
"zip": "11201"
},
"weight": { "unit": "lb", "value": 6 }
}
]
Example:
"false"
⌘I