Ebay Logistics API
Browse all Ebay APIsOfficial vendor OpenAPI document · agent-readyE CommerceShipping Logisticsoauth26 EndpointsREST
For Agents
Fetch eBay-negotiated shipping rates, buy a label for a chosen rate, and cancel or download labels for shipments tied to eBay seller accounts.
Use for: I want to compare eBay-negotiated shipping rates for a 2 lb package to a US ZIP code, Buy a shipping label from a previously fetched eBay shipping quote, Retrieve the shipment details and tracking number for an eBay shipment ID, Download the PDF shipping label for an existing eBay shipment
Not supported: Does not handle order management, listing creation, or buyer messaging - use for eBay shipping rate quotes and label generation only.
The eBay Logistics API gives approved sellers programmatic access to eBay-negotiated shipping rates and label generation. Sellers request a shipping quote for a package, choose from a list of live carrier rates valid for a specific time window, and create a shipment that produces a downloadable shipping label. The API consolidates the rate-shop, label-buy, and cancel flows into six endpoints scoped to a single shipment lifecycle.
Install Jentic One Beta
Connect the Logistics API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Logistics 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://jentic.com/install.sh?src=apis&api=%2Fapis%2Febay.com%2Fsell-logistics" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Febay.com%2Fsell-logistics" | 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 Logistics API.
Request live shipping quotes with multiple carrier rates for a specific package size and route
Purchase a shipping label from a quoted rate and receive a downloadable PDF label file
Retrieve full shipment details including tracking number and total shipping cost
Cancel an unused shipment to void the associated label and refund eBay-negotiated charges
Reuse a shippingQuoteId across multiple sellers participating in the eBay Managed Delivery program
Use Cases
Patterns agents use Logistics API for, with concrete tasks.
★ Discounted Shipping Labels for eBay Sellers
High-volume eBay sellers can fetch eBay-negotiated rates that are typically lower than retail carrier rates and buy labels in one call. The Logistics API returns a list of live rates valid for a fixed window, and createFromShippingQuote turns a chosen rate into a paid shipment with a downloadable label. Integration replaces ad-hoc carrier accounts with a single OAuth-scoped flow against api.ebay.com.
Call POST /shipping_quote with a 2 lb origin/destination package, pick the cheapest rateId, then POST /shipment/create_from_shipping_quote and download the label.
Automated Order Fulfilment Pipelines
Order management systems can integrate the Logistics API to print labels as soon as a buyer pays. The pipeline pulls the order address, requests a shipping quote, selects a rate based on cost or service level, creates the shipment, and stores the resulting tracking number. Each shipment is bound to a shipmentId so cancellations and re-prints flow through the same endpoints.
After receiving an eBay order webhook, request a shipping quote, create a shipment from the cheapest rateId, and persist the tracking number against the order.
Label Cancellation and Refund Handling
When an order is cancelled before dispatch, the seller can call cancelShipment to void the unused label and stop the eBay-negotiated charge. The API enforces cancellation rules tied to the carrier, so agents need to inspect shipment status before retrying. This use case keeps logistics costs aligned with actual fulfilled orders.
POST /shipment/{shipmentId}/cancel for a cancelled order and verify the response confirms the label was voided.
AI Agent Shipping Cost Optimisation
An AI agent invoked from a fulfilment workflow can use Jentic to discover the eBay Logistics shipping_quote operation, fetch live rates, and compare them against the merchant's existing carrier rates before deciding which channel to use. Jentic delivers the OAuth scope and operation schema directly into the agent's context so it can pick a rate without browsing eBay developer docs.
Through Jentic, search 'get ebay shipping rates', load the createShippingQuote schema, and execute it for an order's origin and destination.
Key Endpoints
6 endpoints — the ebay logistics api gives approved sellers programmatic access to ebay-negotiated shipping rates and label generation.
METHOD
PATH
DESCRIPTION
POST
/shipping_quote
Create a shipping quote and return live carrier rates
GET
/shipping_quote/{shippingQuoteId}
Retrieve a previously requested shipping quote
POST
/shipment/create_from_shipping_quote
Buy a label using a chosen rateId
GET
/shipment/{shipmentId}
Retrieve shipment details and tracking
GET
/shipment/{shipmentId}/download_label_file
Download the PDF shipping label
POST
/shipment/{shipmentId}/cancel
Cancel an unused shipment and void the label
POST
/shipping_quote
Create a shipping quote and return live carrier rates
GET
/shipping_quote/{shippingQuoteId}
Retrieve a previously requested shipping quote
POST
/shipment/create_from_shipping_quote
Buy a label using a chosen rateId
GET
/shipment/{shipmentId}
Retrieve shipment details and tracking
GET
/shipment/{shipmentId}/download_label_file
Download the PDF shipping label
POST
/shipment/{shipmentId}/cancel
Cancel an unused shipment and void the label
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the eBay Logistics API by hand means implementing eBay's OAuth 2.0 authorization-code flow for a seller user token, refreshing it, and pointing requests at the api.ebay.com sell/logistics host for quotes and label downloads. Through Jentic you install once, import the Logistics API from the API Directory, store the eBay OAuth credentials once, and your agent calls it.
Permission scoping
Logistics operations put the resource id in the URL path, such as /shipment/{shipmentId} and /shipping_quote/{shippingQuoteId}, so a rule can pin your agent to one shipment or quote. You choose the operations it may call, so you can allow creating quotes and downloading labels while leaving shipment cancellation out unless you add it.
Credential isolation
Your eBay OAuth seller credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'get eBay shipping rates' or 'create an eBay shipping label', and Jentic returns the matching shipping_quote or shipment operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Logistics API through Jentic.
What authentication does the eBay Logistics API use?
The eBay Logistics API uses OAuth 2.0 (the api_auth scheme) scoped to seller accounts. Through Jentic, the OAuth client credentials and refresh tokens stay in your Jentic One instance and the agent only ever receives short-lived scoped access tokens for the call.
Can I get live carrier rates with the eBay Logistics API?
Yes. POST /shipping_quote returns a list of live eBay-negotiated rates valid for a fixed time window, each identified by a rateId you can pass to createFromShippingQuote to buy a label.
What are the rate limits for the eBay Logistics API?
eBay applies per-application call limits set in the developer agreement and tracked in the Application Growth Check program rather than per-endpoint quotas exposed in the spec. Apps approved for Limited Release access receive specific call allowances from eBay.
How do I print an eBay shipping label through Jentic?
Search 'buy ebay shipping label' in Jentic, load the POST /shipment/create_from_shipping_quote schema, pass the rateId from a prior shipping_quote response, then call GET /shipment/{shipmentId}/download_label_file to fetch the PDF.
Can I cancel an eBay shipment after the label is printed?
Yes, while the package has not yet been scanned by the carrier. POST /shipment/{shipmentId}/cancel voids the label and stops the eBay-negotiated charge for that shipment.
Is the eBay Logistics API available to all developers?
No. It is a Limited Release API restricted to sellers approved by eBay business units, and sellers must have a payment method configured on their eBay account before they can create shipments.
Can I limit what my agent is allowed to do with the eBay Logistics API?
Yes. Because you self-host Jentic One, your own rules decide which of the six Logistics operations your agent may call, so you can allow it to create shipping quotes with POST /shipping_quote and download labels via GET /shipment/{shipmentId}/download_label_file while leaving shipment cancellation out. Each operation carries the resource id in the URL path, such as /shipment/{shipmentId} and /shipping_quote/{shippingQuoteId}, so a rule can pin the agent to a single shipment or quote. The eBay OAuth seller credentials stay encrypted in your instance and are injected only at execution time, so the agent never handles them directly.
GET STARTED