The partner rating endpoint is only available to approved partners.
Interested in joining our partner program? Contact us to get started.
The partner rating endpoint allows third-party applications to call Intuitive Shipping directly.
POST Method Endpoint
A custom rating endpoint will be provided to you upon approval into the partner program.
Request Headers
curl -X POST \ {partner_endpoint} \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Domain: {shopify_domain}' \
-H 'X-Api-Key: {api_key}' \
-H 'X-Partner-Key: {partner_key} '\{partner_endpoint}
A custom rating endpoint will be provided to you upon approval.
{shopify_domain}
The full Shopify domain of the shop that the rating request is being performed on. For example test-store.myshopify.com.
{api_key}
A unique API key is associated with each shop account. The API key can be located within the Intuitive Shipping user interface under the Partners page.
{partner_key}
A unique partner key will be provided to you upon approval.
Example Request Payload
{
"rate": {
"origin": {
"country": "CA",
"postal_code": "K2P1L4",
"province": "ON",
"city": "Ottawa",
"name": null,
"address1": "150 Elgin St.",
"address2": "",
"address3": null,
"phone": "16135551212",
"fax": null,
"email": null,
"address_type": null,
"company_name": "Jamie D's Emporium"
},
"destination": {
"country": "CA",
"postal_code": "K1M1M4",
"province": "ON",
"city": "Ottawa",
"name": "Bob Norman",
"address1": "24 Sussex Dr.",
"address2": "",
"address3": null,
"phone": null,
"fax": null,
"email": null,
"address_type": null,
"company_name": null
},
"items": [{
"name": "Short Sleeve T-Shirt",
"sku": "",
"quantity": 1,
"grams": 1000,
"price": 1999,
"vendor": "Jamie D's Emporium",
"requires_shipping": true,
"taxable": true,
"fulfillment_service": "manual",
"properties": null,
"product_id": 48447225880,
"variant_id": 258644705304
}],
"currency": "USD",
"locale": "en"
}
}Example Response
{
"rates": [
{
"service_name": "canadapost-overnight",
"service_code": "ON",
"total_price": "1295",
"description": "This is the fastest option by far",
"currency": "CAD",
"min_delivery_date": "2013-04-12 14:48:45 -0400",
"max_delivery_date": "2013-04-12 14:48:45 -0400"
},
{
"service_name": "fedex-2dayground",
"service_code": "2D",
"total_price": "2934",
"currency": "USD",
"min_delivery_date": "2013-04-12 14:48:45 -0400",
"max_delivery_date": "2013-04-12 14:48:45 -0400"
},
{
"service_name": "fedex-priorityovernight",
"service_code": "1D",
"total_price": "3587",
"currency": "USD",
"min_delivery_date": "2013-04-12 14:48:45 -0400",
"max_delivery_date": "2013-04-12 14:48:45 -0400"
}
]
}Support
If you have any questions, please contact us for assistance.