Get the declaration data for a shipment
curl --request GET \
--url https://{globale_api_domain}/api/shipments/{trackingNumber}import requests
url = "https://{globale_api_domain}/api/shipments/{trackingNumber}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://{globale_api_domain}/api/shipments/{trackingNumber}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{globale_api_domain}/api/shipments/{trackingNumber}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{globale_api_domain}/api/shipments/{trackingNumber}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{globale_api_domain}/api/shipments/{trackingNumber}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{globale_api_domain}/api/shipments/{trackingNumber}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"shipment": {
"trackingNumber": "GK414731769016968912",
"weightUnit": "kg",
"totalWeight": 0.9,
"parcels": [
{
"parcelTrackingNumber": "GK414731769016968912",
"orderId": "GE794624680TS",
"parcelWeight": 0.9,
"products": [
{
"productCode": "W5588R-BLK-XS",
"productName": "Cotton Rib Support Tank",
"originCountryCode": "TR",
"quantity": 2,
"productNetWeight": 0.18,
"productWeight": 0.22,
"exportHsCode": "61091000",
"importHsCode": "61091000",
"discountedPriceForCustomsInClearanceCurrency": 42.5
},
{
"productCode": "W6007R-NVY-M",
"productName": "7/8 High-Waist Airlift Legging",
"originCountryCode": "VN",
"quantity": 1,
"productNetWeight": 0.3,
"productWeight": 0.34,
"exportHsCode": "61046200",
"importHsCode": "61046200",
"discountedPriceForCustomsInClearanceCurrency": 84
}
]
}
]
},
"exportDeclaration": {
"dispatchCountryCode": "NL",
"destinationCountryCode": "GB",
"currencyCode": "GBP",
"incoterm": "DDP",
"exporter": {
"name": "Global-e NL B.V.",
"eoriNumber": "NL859146492",
"vatRegistrationNumber": "NL859146492B01",
"address1": "Krijn Taconiskade 430",
"city": "Amsterdam",
"postalCode": "1087 HW",
"countryCode": "NL"
},
"commercialInvoice": {
"number": "1650338",
"date": "2026-07-27",
"totalValue": 169
}
}
}Get shipment information (Merchant to Global-e)
Retrieve the product, weight, classification and customs-value data Global-e holds for a shipment, plus its export-declaration header, so you can prepare a customs export declaration.
GET
/
api
/
shipments
/
{trackingNumber}
Get the declaration data for a shipment
curl --request GET \
--url https://{globale_api_domain}/api/shipments/{trackingNumber}import requests
url = "https://{globale_api_domain}/api/shipments/{trackingNumber}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://{globale_api_domain}/api/shipments/{trackingNumber}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{globale_api_domain}/api/shipments/{trackingNumber}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{globale_api_domain}/api/shipments/{trackingNumber}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{globale_api_domain}/api/shipments/{trackingNumber}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{globale_api_domain}/api/shipments/{trackingNumber}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"shipment": {
"trackingNumber": "GK414731769016968912",
"weightUnit": "kg",
"totalWeight": 0.9,
"parcels": [
{
"parcelTrackingNumber": "GK414731769016968912",
"orderId": "GE794624680TS",
"parcelWeight": 0.9,
"products": [
{
"productCode": "W5588R-BLK-XS",
"productName": "Cotton Rib Support Tank",
"originCountryCode": "TR",
"quantity": 2,
"productNetWeight": 0.18,
"productWeight": 0.22,
"exportHsCode": "61091000",
"importHsCode": "61091000",
"discountedPriceForCustomsInClearanceCurrency": 42.5
},
{
"productCode": "W6007R-NVY-M",
"productName": "7/8 High-Waist Airlift Legging",
"originCountryCode": "VN",
"quantity": 1,
"productNetWeight": 0.3,
"productWeight": 0.34,
"exportHsCode": "61046200",
"importHsCode": "61046200",
"discountedPriceForCustomsInClearanceCurrency": 84
}
]
}
]
},
"exportDeclaration": {
"dispatchCountryCode": "NL",
"destinationCountryCode": "GB",
"currencyCode": "GBP",
"incoterm": "DDP",
"exporter": {
"name": "Global-e NL B.V.",
"eoriNumber": "NL859146492",
"vatRegistrationNumber": "NL859146492B01",
"address1": "Krijn Taconiskade 430",
"city": "Amsterdam",
"postalCode": "1087 HW",
"countryCode": "NL"
},
"commercialInvoice": {
"number": "1650338",
"date": "2026-07-27",
"totalValue": 169
}
}
}This API is enabled per merchant account by Global-e. If it is not enabled for your account, the request returns
403 Forbidden.Typical integration sequence. These APIs may be used together when an export declaration or bonded reporting is required, but they are independent endpoints — none is a prerequisite for another.
- Get shipping documents — obtain the label and tracking number
- Submit bonded information — report bonded vs free-circulation status per product (when bonded reporting is required)
- Get shipment information — retrieve product, pricing and declaration header data (when you need the data Global-e holds)
- Create the export document — your side, not a Global-e API
- Upload shipment documents — upload the document and its reference to Global-e (when a document must be attached)
- Dispatch orders — End of Day
An export declaration is required only when the shipment leaves the EU customs territory and either contains bonded goods or contains free-circulation goods with a total value of €1,000 or more. When no declaration is required, steps 3 to 5 do not apply.
Bonded vs free-circulation status is submitted separately, through Submit bonded information. This API does not return bonded status.
The response contains commercial values — customs values and commercial-invoice totals. It is returned with
Cache-Control: no-store. Do not cache or store it beyond the immediate purpose of preparing the declaration.Global-e never returns partial declaration data. If a value the declaration requires is not yet available, the call returns
409 with no exportDeclaration section. This is a permanent gap rather than a not-yet-ready state, so contact Global-e instead of retrying.Path Parameters
Tracking number identifying the shipment. This is the parcel's carrier tracking number when it has one, and otherwise the order's tracking number. Global-e returns the shipment only if it belongs to your merchant account.
Required string length:
1 - 50Response
The shipment was found and all the data the declaration requires is available.
The shipment, with its weights and its parcels.
Show child attributes
Show child attributes
The export-declaration header. Together with each product's HS codes and customs value, this is what you need to prepare the declaration. The declaration is in a single currency, so no exchange rate is returned.
Show child attributes
Show child attributes