eBay Sell Compliance API
Browse all Ebay APIs★ Only Publicly Available OpenAPI DocumentE CommerceStorefrontapiKey3 EndpointsREST
For Agents
Read eBay listing violations, summary counts, and suppress remediated issues so agents can keep large catalogues free of suppression risk.
Use for: I want to find every listing flagged for missing GTIN, Get a summary of compliance violations on the seller account, List all listings at risk of removal, Suppress a violation that has been remediated
Not supported: Does not handle listing creation, order processing, or financial settlement - use for reading and suppressing eBay listing compliance violations only.
Jentic publishes the only available OpenAPI specification for eBay Sell Compliance API, keeping it validated and agent-ready. Sell Compliance is the canonical sell- namespace surface for eBay listing risk - detailed violations, summary counts grouped by compliance type, and a suppression endpoint for clearing remediated violations. Sellers, agencies, and catalogue automation tools rely on it to keep listings free of suppression risk on US, UK, EU, and AU marketplaces. The standard workflow is poll, fix at scale, then suppress.
Install Jentic One Beta
Connect the eBay Sell Compliance API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the eBay Sell Compliance 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%2Fapi.ebay.com%2Febay-sell-compliance-api" | 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%2Fapi.ebay.com%2Febay-sell-compliance-api" | 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 eBay Sell Compliance API.
Retrieve detailed listing violations filtered by listing ID, compliance type, or marketplace
Pull a summary of violation counts grouped by compliance type to drive triage
Suppress a specific listing violation once the underlying issue is fixed
Filter violations by remediation requirement and compliance state to focus urgent cases
Page through large violation result sets for accounts with thousands of listings
Use Cases
Patterns agents use eBay Sell Compliance API for, with concrete tasks.
★ Daily violation triage
Operations teams running large eBay catalogues can call GET /listing_violation_summary every morning to see counts grouped by compliance type, then drill into GET /listing_violation for the highest-impact bucket. The pattern surfaces the few violation categories blocking the most listings so engineering effort lands where it removes the most risk.
Call GET /listing_violation_summary, pick the top compliance_type bucket by count, then call GET /listing_violation filtered by that type
Bulk remediation and suppression
Once a violation is fixed in the catalogue (e.g., missing GTINs added across hundreds of listings), the seller calls POST /suppress_listing_violation per listing to clear the resolved record. Bulk suppression restores listing visibility quickly - without it, stale violation flags can continue to suppress search rank.
After updating GTINs across affected listings, iterate the listing IDs and call POST /suppress_listing_violation for each to clear the resolved violations
Marketplace-specific compliance monitoring
Sellers operating across multiple eBay marketplaces face different compliance regimes per region. Calling GET /listing_violation with a marketplace_ids filter isolates issues per region - for example PRODUCT_SAFETY violations only on EBAY_DE - so localisation teams can address them with the right legal copy.
Call GET /listing_violation with marketplace_ids EBAY_DE and compliance_type PRODUCT_SAFETY to surface listings needing GPSR-compliant content
Agent-driven compliance copilot via Jentic
An AI agent acting as a compliance copilot can search Jentic for the eBay listing-violation summary operation and execute it daily. When a bucket exceeds threshold the agent drills into the detail endpoint, drafts remediation, and posts updates back to the catalogue tool. Jentic keeps the credential in the vault.
Search Jentic for 'check ebay listing violations', execute GET /listing_violation_summary, and if any compliance_type bucket exceeds 50, fetch detail and produce a remediation list
Key Endpoints
3 endpoints — jentic publishes the only available openapi specification for ebay sell compliance api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/listing_violation
Retrieve detailed listing violations
GET
/listing_violation_summary
Pull violation counts grouped by type
POST
/suppress_listing_violation
Suppress a remediated violation
GET
/listing_violation
Retrieve detailed listing violations
GET
/listing_violation_summary
Pull violation counts grouped by type
POST
/suppress_listing_violation
Suppress a remediated violation
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the eBay Sell Compliance API by hand means setting up its API key auth and coding your own reads and suppressions of listing violations. Through Jentic you install once, import the eBay Sell Compliance API from the API Directory, store the key once, and your agent calls it.
Permission scoping
eBay Sell Compliance violation targets travel in the request body rather than as ids in the URL path, so limit the agent to the operations it needs, such as reading listing violations and their summary, and leave suppress_listing_violation out of the allowed set. Every operation you grant is your explicit choice.
Credential isolation
Your eBay API key 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 'list listing compliance violations' or 'summarize violations for a seller', and Jentic returns the matching eBay Sell Compliance 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 eBay Sell Compliance API through Jentic.
Why is there no official OpenAPI spec for eBay Sell Compliance API?
eBay does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call eBay Sell Compliance API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the Sell Compliance API use?
The spec declares an `api_auth` API-key scheme passed via the `api_auth` header. eBay seller APIs accept an OAuth 2.0 user token in this header position with the sell.account / sell.inventory scopes. Through Jentic, the credential is stored in your Jentic One instance and injected at execution time.
How is sell-compliance different from compliance-api?
Sell Compliance is the same 3-endpoint surface under eBay's modern sell- namespace; compliance-api is the legacy slug. New integrations should target sell-compliance.
Can I suppress a remediated violation through Jentic?
Yes. Install with `pip install jentic`, search Jentic for `suppress an ebay listing violation`, load the schema for POST /suppress_listing_violation, populate listingId and complianceType, and execute. The violation is cleared from the listing's risk record.
What are the rate limits for the Sell Compliance API?
Sell Compliance inherits eBay's per-application daily limit - typically 5,000 calls per day in production with per-second burst caps. For very large catalogues paginate aggressively and prefer the summary endpoint for monitoring.
What is the difference between the summary and detail endpoints?
GET /listing_violation_summary returns aggregate counts grouped by compliance type - useful for dashboards and triggers. GET /listing_violation returns the per-listing records with full reason text and remediation guidance - use this once you know which compliance type to triage.
Can I limit what my agent is allowed to do with the eBay Sell Compliance API?
Yes. Because you run Jentic One yourself, your own rules decide which of the three operations the agent may call and which credentials it may use. For a read-only compliance monitor, grant only GET /listing_violation and GET /listing_violation_summary and leave the mutating POST /suppress_listing_violation out of the allowed set, so the agent can surface listing violations and their summary counts but cannot clear any record. Every operation the agent can reach is a choice you make explicitly.
GET STARTED