Create an Import Cost Estimate
Availability: Public Preview
This endpoint is currently in public preview and available only to approved accounts. Please contact Arta to request access for your organization.
Create an import cost estimate to calculate cross-border duties, fees, and taxes for your international shipments.
Body
-
import_cost_estimate
object
POST
/import_cost_estimates
curl \
--request POST 'https://api.arta.io/import_cost_estimates' \
--header "Content-Type: application/json" \
--header "Authorization: ARTA_APIKey s0e1t2e3c4a5s6t7r8o9n10o11m12y" \
--data '{"import_cost_estimate":{"origin":{"country":"US"},"objects":[{"value":"10869.45","hs_code":"691390","reference":"ceramic-vase-maria-lundqvist"}],"currency":"USD","transport":{"amount":"20000","service_level":"ups_expedited"},"destination":{"region":"ON","country":"CA"}}}'
Request example
{
"import_cost_estimate": {
"origin": {
"country": "US"
},
"objects": [
{
"value": "10869.45",
"hs_code": "691390",
"reference": "ceramic-vase-maria-lundqvist"
}
],
"currency": "USD",
"transport": {
"amount": "20000",
"service_level": "ups_expedited"
},
"destination": {
"region": "ON",
"country": "CA"
}
}
}
Response examples (201)
{
"id": "30e1d8e7-f175-46c7-afee-8aa16c9d988b",
"origin": {
"country": "BR"
},
"status": "success",
"end_use": "for_resale",
"objects": [
{
"value": "10869.45",
"hs_code": "691390",
"quantity": 1,
"reference": "ceramic-vase-maria-lundqvist",
"value_currency": "USD",
"country_of_origin": null
}
],
"currency": "USD",
"estimate": {
"summary": {
"fees": "147.13",
"taxes": "1754.97",
"duties": "2119.53"
},
"line_items": [
{
"type": "duty",
"amount": "706.51",
"subtype": "item",
"description": "duty"
}
]
},
"reference": null,
"shortcode": "JANANI-I5Y6SR",
"transport": {
"amount": "20000.00",
"service_level": "ups_expedited",
"amount_currency": "USD"
},
"destination": {
"city": null,
"region": "ON",
"country": "CA",
"postal_code": null
}
}
Response examples (400)
# Headers
content-type: application/json
x-arta-request-id: FkBjuxbwLLTx4RoAARkx
# Payload
{
"errors": {
"detail": "string"
}
}