Landed Cost
Retrieve Landed Cost Calculation
What this endpoint does
This GET endpoint lets your merchants retrieve the full landed cost calculation for a specific request using its unique landedcost_request_id.
Use this to retrieve the exact landed cost breakdown for a transaction, including all itemized taxes, duties, and jurisdiction details by passing the landedcost_request_id that was returned by the Calculate landed cost endpoint.
This ensures you can:
- Safely replay results for auditing or compliance.
- Display the same landed cost breakdown to the customer, even if they return to checkout later.
GET
/
v1
/
landed-cost
/
{landedcost_request_id}
Retrieve Landed Cost Calculation
curl --request GET \
--url https://api.openborder.com/api/direct/v1/landed-cost/{landedcost_request_id} \
--header 'x-openborder-direct-api-key: <x-openborder-direct-api-key>'import requests
url = "https://api.openborder.com/api/direct/v1/landed-cost/{landedcost_request_id}"
headers = {"x-openborder-direct-api-key": "<x-openborder-direct-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'x-openborder-direct-api-key': '<x-openborder-direct-api-key>'}
};
fetch('https://api.openborder.com/api/direct/v1/landed-cost/{landedcost_request_id}', 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://api.openborder.com/api/direct/v1/landed-cost/{landedcost_request_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-openborder-direct-api-key: <x-openborder-direct-api-key>"
],
]);
$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://api.openborder.com/api/direct/v1/landed-cost/{landedcost_request_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-openborder-direct-api-key", "<x-openborder-direct-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.openborder.com/api/direct/v1/landed-cost/{landedcost_request_id}")
.header("x-openborder-direct-api-key", "<x-openborder-direct-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.openborder.com/api/direct/v1/landed-cost/{landedcost_request_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-openborder-direct-api-key"] = '<x-openborder-direct-api-key>'
response = http.request(request)
puts response.read_body{
"landedcost_request_id": "<string>",
"currency_code": "<string>",
"external_reference_id": "<string>",
"created_at": "<string>",
"usd_conversion_rate": 123,
"shipments": [
{
"shipment_id": "<string>",
"shipment_type": "cross_border",
"shipping_rate_taxes": [
{
"shipping_rate_id": "<string>",
"shipping_rate": 123,
"tax_transaction_id": "<string>",
"landed_cost": {
"duties": 123,
"total_taxes": 123,
"shipment_taxes": 123,
"product_taxes": 123,
"breakdown": [
{
"type": "shipment_tax",
"tax_name": "<string>",
"rate": 123,
"amount": 123,
"taxable_amount": 123,
"jurisdiction": {
"name": "<string>",
"type": "<string>"
},
"sku": "<string>"
}
]
}
}
]
}
],
"hs_codes": [
{
"sku": "<string>",
"hs_code": "<string>"
}
]
}Headers
OpenBorder merchant API token
Path Parameters
Response
Landed cost previously calculated.
Unique ID for this tax calculation request, must be submitted with the final order — store this for auditing or support.
ISO 4217 currency code used for all amounts (e.g., "CAD").
Your original reference ID (e.g., cart or session ID) — helps link this calculation back to your system.
ISO timestamp showing when the calculation was processed.
Conversion rate from the returned currency to USD at the time of calculation — useful for reporting.
List of results for each shipment you submitted.
Show child attributes
Show child attributes
The HS Code each product has been classified to. Availability Note: This field is conditionally populated in the response body. It will only be included if your merchant configuration requires the HS Code for proper processing (ex. international shipping or customs declaration). If the field is not required for your integration, a null value will be returned.
Show child attributes
Show child attributes
⌘I
Retrieve Landed Cost Calculation
curl --request GET \
--url https://api.openborder.com/api/direct/v1/landed-cost/{landedcost_request_id} \
--header 'x-openborder-direct-api-key: <x-openborder-direct-api-key>'import requests
url = "https://api.openborder.com/api/direct/v1/landed-cost/{landedcost_request_id}"
headers = {"x-openborder-direct-api-key": "<x-openborder-direct-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'x-openborder-direct-api-key': '<x-openborder-direct-api-key>'}
};
fetch('https://api.openborder.com/api/direct/v1/landed-cost/{landedcost_request_id}', 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://api.openborder.com/api/direct/v1/landed-cost/{landedcost_request_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-openborder-direct-api-key: <x-openborder-direct-api-key>"
],
]);
$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://api.openborder.com/api/direct/v1/landed-cost/{landedcost_request_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-openborder-direct-api-key", "<x-openborder-direct-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.openborder.com/api/direct/v1/landed-cost/{landedcost_request_id}")
.header("x-openborder-direct-api-key", "<x-openborder-direct-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.openborder.com/api/direct/v1/landed-cost/{landedcost_request_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-openborder-direct-api-key"] = '<x-openborder-direct-api-key>'
response = http.request(request)
puts response.read_body{
"landedcost_request_id": "<string>",
"currency_code": "<string>",
"external_reference_id": "<string>",
"created_at": "<string>",
"usd_conversion_rate": 123,
"shipments": [
{
"shipment_id": "<string>",
"shipment_type": "cross_border",
"shipping_rate_taxes": [
{
"shipping_rate_id": "<string>",
"shipping_rate": 123,
"tax_transaction_id": "<string>",
"landed_cost": {
"duties": 123,
"total_taxes": 123,
"shipment_taxes": 123,
"product_taxes": 123,
"breakdown": [
{
"type": "shipment_tax",
"tax_name": "<string>",
"rate": 123,
"amount": 123,
"taxable_amount": 123,
"jurisdiction": {
"name": "<string>",
"type": "<string>"
},
"sku": "<string>"
}
]
}
}
]
}
],
"hs_codes": [
{
"sku": "<string>",
"hs_code": "<string>"
}
]
}