Ebay Logistics API
Browse all Ebay APIs✓ Official Vendor SpecE 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://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 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?
Three things that make agents converge on Jentic-routed access.
Credential isolation
eBay Logistics OAuth 2.0 client credentials and refresh tokens are stored encrypted in the Jentic vault. Agents receive short-lived access tokens scoped to the sell.logistics scope at call time and never see the raw client secret.
Intent-based discovery
Agents search natural-language intents like 'get ebay shipping rates' and Jentic returns the matching shipping_quote and shipment operations with input schemas, so the agent can call the right endpoint without reading eBay developer docs.
Time to first call
Direct eBay Logistics integration takes about 3-5 days to implement OAuth, business-unit approval, label download handling, and cancellation flows. Through Jentic the search-load-execute path takes under an hour once the seller account is connected.
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 the Jentic vault 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.
GET STARTED