Get Shipment by Id

The operation retrieves shipment details using shipmentId.

SecuritybearerAuth

Request

path Parameters

shipmentId

required

string

The shipmentId, a unique identifier for an individual Shipment.

header Parameters

X-PB-Developer-Partner-Id

string

The Developer Partner ID is assigned by PB to uniquely identify a Developer's strategic business partners. If the developer is the sole business partner, this field isn't required.

Responses

200

The shipment has been retrieved.

400

Invalid request.

401

The request could not be authorized.

404

The requested resource was not found.

500

The request could not be completed due to an internal error.

get/api/v1/shipments/{shipmentId}

Request samples

Response samples

application/json

{"correlationId": "49ce304a251447539c84b204d968d7c4",
"subId": "sac735d",
"fromAddress": {"name": "Sender Name",
"addressLine1": "1600 Amphitheatre Parkway",
"addressLine2": "near abc street",
"addressLine3": "near xyz street",
"company": "PB",
"email": "testuser@gmail.com",
"phone": "6502530000",
"cityTown": "Mountain View",
"stateProvince": "CA",
"postalCode": "94043",
"inductionPostalCode": "06905",
"countryCode": "US",
"residential": true
},
"toAddress": {"name": "Sender Name",
"addressLine1": "1600 Amphitheatre Parkway",
"addressLine2": "near abc street",
"addressLine3": "near xyz street",
"company": "PB",
"email": "testuser@gmail.com",
"phone": "6502530000",
"cityTown": "Mountain View",
"stateProvince": "CA",
"postalCode": "94043",
"inductionPostalCode": "06905",
"countryCode": "US",
"residential": true
},
"altReturnAddress": {"name": "Paul Wright",
"addressLine1": "24182 Kathy Ave",
"cityTown": "Lake Forest",
"stateProvince": "CA",
"postalCode": "92630-1827",
"countryCode": "US",
"phone": "203-555-1213",
"residential": false
},
"parcelTrackingNumber": "UPS2202625646462636",
"serviceId": "NDA",
"rates": [{"baseCharge": 102.45,
"carrier": "UPS",
"currencyCode": "USD",
"parcelType": "PKG",
"rateTypeId": "COMMERCIAL",
"serviceId": "NDA",
"specialServices": [{"specialServiceId": "ADULT_SIG",
"fee": 9.35,
"inputParameters": [{"name": "INPUT_VALUE",
"value": "200.00"
}
]
}
],
"surcharges": [{"fee": 32.32,
"name": "FUEL"
}
],
"totalCarrierCharge": 140.35,
"isHazmat": false
}
],
"shipmentId": "UPS2202625646462636",
"shipmentOptions": {"billingWeight": "16.00"
},
"customs": {"customsInfo": {"reasonForExport": "DOCUMENTS",
"comments": "Test comment",
"invoiceNumber": "001189223",
"importerCustomsReference": "987654",
"sdrValue": 23.32,
"EELPFC": "NOEEI 30.2D2",
"currencyCode": "USD",
"fromCustomsReference": "EFEFE4554545",
"licenseNumber": "456ABC123",
"certificateNumber": "987",
"customsDeclaredValue": 6000,
"termsOfSale": "DDP"
},
"customsItems": [{"description": "Books",
"itemId": "item1",
"orderNumber": "ORD1",
"quantity": 1,
"unitPrice": 3000,
"weightUnit": "OZ",
"weight": 0.1,
"hSTariffCode": "AST559",
"originCountryCode": "US"
}
],
"customsDocuments": [{"fileName": "invoice.pdf",
"s3FileId": "uploads/shipping/intl_docs/sa58a03/0oa2bxnhu03i48mh50h8/NJ3ww7gv73kwDJK/DRNgGjEraOvV8ZB_invoice.pdf",
"documentType": "INVOICE"
}
]
},
"status": "Label Printed",
"carrier": "ups",
"carrierAccountId": "EQ7Ar2dmXXX",
"metadata": [{"name": "costAccountName",
"value": "cost account 123"
}
],
"parcel": {"length": 2,
"width": 1,
"height": 1,
"dimUnit": "IN",
"weightUnit": "OZ",
"weight": 2,
"packageValue": 2
},
"dispenseClient": "api",
"refundStatus": "string",
"isInternational": true,
"isReturnLblRequested": false,
"insured": true,
"carrierCode": "string",
"transactionCreateDate": "2026-02-09T07:22:05.457Z",
"locationId": "zLwdWnZ7LyVWknO",
"references": {"reference1": "custome message",
"reference2": "SendTech",
"reference3": "98437",
"reference4": "Overnight Shipping",
"poNumber": "R2W 2H2",
"department": "Name department",
"additionalReference1": "612987641",
"additionalReference2": "989"
},
"ecommerceProvider": {"customer": {"id": "CUST12345",
"email": "john.doe@example.com",
"first_name": "John",
"last_name": "Doe"
},
"orderNumber": "3865"
}
}