Schedule a Call
Shopify Get Shipping Rates API
by Ha Nguyen0 CommentsShopify

Shipping is one of the most critical components of e-commerce success. From checkout transparency to fulfillment speed, customers expect accurate, real-time shipping cost calculations — not surprises at the final step.

That’s where Shopify’s Get Shipping Rates API comes in. This API gives developers and merchants access to real-time carrier rate data, allowing for custom logic, optimized shipping options, and improved customer experience.

In 2025, the Shopify Shipping Rates API has evolved to become more powerful, flexible, and integrated with major global carriers (like UPS, USPS, DHL, and FedEx). Whether you’re building a custom checkout app or optimizing fulfillment logic, understanding this API is essential.

Shopify Get Shipping Rates API

Core API Endpoint: /admin/api/2025-01/carrier_services.json

Shopify provides the CarrierService API, which enables you to register an external service that calculates rates dynamically.

You can use it to:

  • Retrieve current rates (GET)

  • Create or update a custom carrier (POST/PUT)

  • Delete a carrier service (DELETE)

Example Request: Registering a Carrier Service

POST /admin/api/2025-01/carrier_services.json
{
"carrier_service": {
"name": "Custom Shipping API",
"callback_url": "https://yourapp.com/rates",
"service_discovery": true
}
}

Response Example

{
"carrier_service": {
"id": 123456789,
"name": "Custom Shipping API",
"callback_url": "https://yourapp.com/rates",
"service_discovery": true,
"format": "json",
"active": true
}
}

Once registered, Shopify will send rate requests to your callback_url whenever checkout is initiated.

How the Callback Works (The Core of Get Shipping Rates)

When a customer proceeds to shipping, Shopify sends a POST request to your callback endpoint with details about the order.

Example Request Payload from Shopify

{
"rate": {
"origin": {
"country": "US",
"postal_code": "94043",
"province": "CA",
"city": "Mountain View",
"name": "Your Warehouse"
},
"destination": {
"country": "US",
"postal_code": "10001",
"province": "NY",
"city": "New York"
},
"items": [
{
"name": "T-shirt",
"quantity": 2,
"grams": 200
}
],
"currency": "USD",
"locale": "en"
}
}

Your API (the custom callback URL) must respond with available rates.

Example Response (Returning Shipping Rates)

{
"rates": [
{
"service_name": "Standard Shipping",
"service_code": "STANDARD",
"total_price": "500",
"currency": "USD",
"min_delivery_date": "2025-10-30T10:00:00-04:00",
"max_delivery_date": "2025-11-02T20:00:00-04:00"
},
{
"service_name": "Express Shipping",
"service_code": "EXPRESS",
"total_price": "1200",
"currency": "USD",
"min_delivery_date": "2025-10-31T10:00:00-04:00",
"max_delivery_date": "2025-11-01T18:00:00-04:00"
}
]
}

Shopify will then display these options directly in the checkout page.

Authentication and Permissions

To access the Shipping Rates API, you must have:

  • Admin API access token (for private apps or custom apps)

  • Permissions:

    • write_shipping

    • read_shipping

    • write_orders (for advanced integrations)

Authentication is handled via HTTP headers:

X-Shopify-Access-Token: your-access-token
Content-Type: application/json

Example Use Case: Custom Carrier Rate Calculation

Let’s say you want to charge shipping based on product type instead of weight.

Example logic:

  • Apparel → $5 flat

  • Electronics → $10 flat

  • Accessories → $3 flat

You can implement this directly in your callback API:

app.post('/rates', (req, res) => {
const items = req.body.rate.items;
let total = 0;items.forEach(item => {
if (item.name.includes(‘Shirt’)) total += 500;
else if (item.name.includes(‘Headphones’)) total += 1000;
else total += 300;
});const rates = [{
service_name: “Custom Flat Rate”,
service_code: “FLAT”,
total_price: total.toString(),
currency: “USD”,
min_delivery_date: new Date().toISOString(),
max_delivery_date: new Date(Date.now() + 3 * 86400000).toISOString()
}];res.json({ rates });
});

This flexibility is what makes the Shipping Rates API invaluable for customized business logic.

Shopify Get Shipping Rates via Storefront API

Developers building custom storefronts (React, Vue, Next.js, etc.) can fetch rates using the Storefront API’s cartShippingRatesUpdate mutation.

GraphQL Example:

mutation getShippingRates($cartId: ID!, $address: MailingAddressInput!) {
cartShippingAddressUpdate(cartId: $cartId, shippingAddress: $address) {
cart {
shippingLines {
title
priceV2 {
amount
currencyCode
}
}
}
}
}

This is perfect for headless Shopify setups that require dynamic rate updates before checkout completion.

The Shopify Get Shipping Rates API is an essential tool for developers and e-commerce brands in 2025. It provides real-time, flexible control over how shipping costs are calculated and displayed — bridging the gap between customer experience and operational efficiency.

By integrating this API into your store or custom app, you can:

  • Deliver accurate, real-time rates

  • Automate shipping workflows

  • Enhance checkout transparency

  • Ultimately, increase conversions and customer trust

Whether you’re building a logistics platform, optimizing fulfillment, or developing a headless Shopify storefront — mastering this API is your gateway to smarter, faster, and more profitable e-commerce shipping.

Leave A Comment

Your email address will not be published. Required fields are marked *