Easyship API
✓ Official Vendor SpecE CommerceShipping Logisticsbearer51 EndpointsREST
For Agents
Create and manage shipments, calculate multi-courier rates, validate addresses, generate shipping labels, and track parcels through the Easyship logistics platform.
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.
Install Jentic One Beta
Connect the Easyship API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Easyship API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Easyship 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
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
Use Cases
Patterns agents use Easyship 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.
Key Endpoints
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
POST
/rates
Calculate multi-courier shipping rates
POST
/shipments
Create a new shipment
GET
/shipments/{id}
Retrieve shipment details
DELETE
/shipments/{id}
Cancel a shipment
GET
/shipments/{id}/documents
Retrieve shipping label and documents
GET
/shipments/{id}/trackings
Get courier tracking events
POST
/addresses/validate
Validate a postal address
POST
/shipments/{id}/insure
Insure a shipment
POST
/rates
Calculate multi-courier shipping rates
POST
/shipments
Create a new shipment
GET
/shipments/{id}
Retrieve shipment details
DELETE
/shipments/{id}
Cancel a shipment
GET
/shipments/{id}/documents
Retrieve shipping label and documents
GET
/shipments/{id}/trackings
Get courier tracking events
POST
/addresses/validate
Validate a postal address
POST
/shipments/{id}/insure
Insure a shipment
Why Jentic?
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.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Complementary
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.
FAQs
Specific to using Easyship 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.
GET STARTED