For Agents
Create and manage shipments, calculate multi-courier rates, validate addresses, generate shipping labels, and track parcels through the Easyship logistics platform.
Get started with Easyship API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"calculate shipping rates and create a shipment"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Easyship API API.
Compare shipping rates across registered couriers for a given parcel and destination
Create, update, or cancel a shipment record with sender, recipient, and parcel dimensions
Generate and download shipping documents including labels and customs paperwork
Validate a postal address against courier-specific format requirements
GET STARTED
Use for: Create a shipment from London to New York for a 1kg parcel, Calculate the cheapest courier rate for shipping to Singapore, Generate a shipping label for shipment ID SHP-12345, Validate a customer-supplied delivery address before checkout
Not supported: Does not handle order capture, payment processing, or warehouse management — use for Easyship rate calculation, shipment creation, label generation, and parcel tracking only.
Easyship is a global shipping platform that aggregates rates and label generation across hundreds of couriers for direct-to-consumer brands and marketplaces. The API exposes endpoints for managing shipments end to end, calculating rates, registering and configuring couriers, validating addresses, generating shipping documents, and tracking parcels through the courier network. It is used by Shopify, BigCommerce, and custom storefronts that need multi-courier shipping without integrating each carrier individually.
Insure a shipment in line with the declared parcel value
Track a parcel through every leg of the courier network
Manage saved sender and recipient addresses for repeat shipments
Patterns agents use Easyship API API for, with concrete tasks.
★ Multi-courier rate shopping at checkout
E-commerce checkouts surface the cheapest or fastest shipping option to the buyer in real time. An agent calls POST /rates with the cart's parcel and destination details, then displays the ranked courier options. Easyship returns rates from every courier connected on the merchant's account in a single call, removing the need to integrate each one.
Call POST /rates with origin postcode SW1A1AA, destination postcode 10001, and a 1kg parcel, then return the three cheapest courier options with their service names.
End-to-end shipment fulfilment
Once a buyer pays, the merchant creates the shipment, generates a label, and hands the parcel to the chosen courier. POST /shipments creates the record, GET /shipments/{id}/documents returns the label PDF, and GET /shipments/{id}/trackings exposes the courier events back to the buyer. The full flow is three endpoints rather than per-courier integrations.
Create a shipment for order ORD-789 with the supplied sender, recipient, and parcel details, then download the shipping label as a PDF.
Address validation at the moment of capture
Failed deliveries from typo'd addresses are expensive. POST /addresses/validate scrubs each customer-supplied address against courier-specific rules at the moment of entry, surfacing corrections to the buyer before the order is placed and saving redelivery fees downstream.
Validate the supplied recipient address and return either 'valid' or the suggested correction returned by Easyship.
Customer-facing parcel tracking
Brands embed live tracking inside their order status page rather than redirecting buyers to courier websites. GET /shipments/{id}/trackings returns every event captured by the courier so the merchant's UI can render a unified timeline regardless of which courier carries the parcel.
Fetch tracking for shipment SHP-12345 and return the most recent event with its timestamp and courier description.
Agent-driven shipping operations
Through Jentic, an operations agent translates natural-language requests like 'ship this order with the cheapest courier' or 'cancel and re-rate shipment 12345' into the right combination of /rates, /shipments, and /shipments/{id} calls. The agent does not need to know the 51-endpoint surface — Jentic resolves the right operation by intent.
Given an order ID and the cheapest courier from a prior /rates call, create the matching shipment and generate a label.
51 endpoints — easyship is a global shipping platform that aggregates rates and label generation across hundreds of couriers for direct-to-consumer brands and marketplaces.
METHOD
PATH
DESCRIPTION
/rates
Calculate multi-courier shipping rates
/shipments
Create a new shipment
/shipments/{id}
Retrieve shipment details
/shipments/{id}
Cancel a shipment
/shipments/{id}/documents
Retrieve shipping label and documents
/shipments/{id}/trackings
Get courier tracking events
/addresses/validate
Validate a postal address
/shipments/{id}/insure
Insure a shipment
/rates
Calculate multi-courier shipping rates
/shipments
Create a new shipment
/shipments/{id}
Retrieve shipment details
/shipments/{id}
Cancel a shipment
/shipments/{id}/documents
Retrieve shipping label and documents
Three things that make agents converge on Jentic-routed access.
Credential isolation
Easyship bearer tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens — the raw bearer token never enters the agent's context, prompts, or logs.
Intent-based discovery
Agents search Jentic for intents like 'compare shipping rates' or 'create a shipping label' and Jentic returns the matching Easyship operations from the 51-endpoint surface, with their input schemas pre-loaded.
Time to first call
Direct Easyship integration: 3-5 days to wire auth, rate shopping, shipment creation, document download, and tracking polling. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
ShipStation API
US-focused multi-courier shipping platform with deep marketplace integrations
Choose ShipStation when the volume is concentrated in the US and the team already uses Amazon, eBay, and Walmart connectors; pick Easyship when international and cross-border shipping dominate.
Shopify Admin API
Order source that feeds shipments into Easyship
Use Shopify alongside Easyship when orders originate in Shopify and the agent fulfils them through Easyship's multi-courier rates.
Stripe API
Payment processing for the order before shipment is generated
Use Stripe alongside Easyship to confirm payment success before creating the shipment and generating a label.
Specific to using Easyship API API through Jentic.
What authentication does the Easyship API use?
Easyship uses HTTP bearer authentication. The token is passed in the Authorization header on every request. Through Jentic, the bearer token is stored encrypted in the vault (MAXsystem) and injected at execution time, so it never enters the agent's context or logs.
Can I generate shipping labels with the Easyship API?
Yes. After creating a shipment with POST /shipments, call GET /shipments/{id}/documents to retrieve the courier-issued shipping label and any required customs paperwork as a downloadable PDF.
What are the rate limits for the Easyship API?
The OpenAPI spec does not publish numeric rate limits. Easyship applies per-account quotas tied to plan tier and traffic profile — monitor 429 responses, back off on burst, and contact Easyship support for the limit applied to your subscription.
How do I rate-shop and create a shipment through Jentic?
Search Jentic for 'compare shipping rates', load the schema for POST /rates, execute, then chain into POST /shipments using the chosen courier. The flow is: pip install jentic, then await client.search, await client.load, await client.execute, repeated for each step.
Does the Easyship API support insurance and customs documents?
Yes. POST /shipments/{id}/insure attaches insurance up to the declared parcel value, and the customs paperwork required for cross-border shipments is included in the response from GET /shipments/{id}/documents alongside the label.
Can I cancel a shipment after it has been created?
Yes. DELETE /shipments/{id} cancels a shipment that has not yet been collected by the courier. Once collection has occurred, cancellation must be handled directly with the courier.
/shipments/{id}/trackings
Get courier tracking events
/addresses/validate
Validate a postal address
/shipments/{id}/insure
Insure a shipment