Easyship API

Name: Easyship API
Brand: Easyship API
Availability: InStock

✓ 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.

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.

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 | sh

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 instance

Jentic 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

GET STARTED

Start building with Easyship API

Explore with Jentic

View OpenAPI Document

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

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your Easyship bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'compare shipping rates' or 'create a shipping label', and Jentic returns the matching Easyship operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

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 your Jentic One instance 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.

Can I limit what my agent is allowed to do with the Easyship API?

Yes. Because you run Jentic One yourself, your own rules decide which Easyship operations and credentials the agent may use. Easyship puts the shipment id in the URL path, so you can pin the agent to a single shipment and let it read only that shipment's documents and tracking through GET /shipments/{id}/documents and GET /shipments/{id}/trackings. You choose the operations it may call, so destructive ones like DELETE /shipments/{id} are excluded unless you add them, and the bearer token stays with your instance and is injected only at execution time.

Easyship API

Connect the Easyship API to your agent

Capabilities

Start building with Easyship API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs