Sell Compliance API

Name: Sell Compliance API API
Brand: Compliance API
Availability: InStock

✓ Official Vendor SpecE CommerceStorefrontoauth22 EndpointsREST

For Agents

Detect which seller listings violate eBay listing policies. Two endpoints — summary counts and per-listing detail with recommended fixes.

Quickstart

Get started with Sell Compliance API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"find eBay listings with compliance violations"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Sell Compliance API API.

List per-listing compliance violations grouped by violation type

Read summary counts of violations across the seller's active inventory

Filter violations by compliance type (e.g., RESTRICTED_ITEM, MISSING_PHOTO, ITEM_SPECIFICS)

Read recommended remediation actions for each detected violation

GET STARTED

Start building with Sell Compliance API API

Explore with Jentic

View OpenAPI Document

The eBay Sell Compliance API tells sellers which of their active listings violate, or are at risk of violating, eBay listing policies — restricted-item rules, missing item specifics, image quality, brand-protection flags, regional take-back disclosures, and others. Two endpoints cover the full surface — /listing_violation_summary returns a count of violations grouped by compliance type, and /listing_violation returns the per-listing detail (listingId, violation reason, recommended fix). Sellers wire it into their listing-management tools so they catch and resolve violations before eBay suppresses or removes the listings.

Use Cases

Patterns agents use Sell Compliance API API for, with concrete tasks.

★ Compliance triage queue in a listing tool

Listing-management tools call /listing_violation_summary nightly to render a triage dashboard — total violations bucketed by compliance type, with the highest-impact buckets surfaced first. The seller drills into a bucket and the tool calls /listing_violation with the matching compliance_type filter to show every offending listingId and its recommended fix, ready for one-click remediation.

Call /listing_violation_summary, identify the bucket with the highest count, then call /listing_violation filtered to that compliance_type and return the full listing list

Pre-removal alerting

Sellers want to know about at-risk listings before eBay actually demotes or removes them. The integration polls /listing_violation on a daily schedule and pipes any AT_RISK status results into a notification system (Slack, email). The seller fixes the listing through the Inventory API before the violation is enforced, preserving impressions and avoiding a status hit.

Poll /listing_violation daily, filter to entries with violationStatus=AT_RISK, and post a Slack message with each listingId and reason

Bulk fix workflow

When eBay rolls out a new item-specifics requirement (e.g., a new mandatory aspect for a category), thousands of older listings can become non-compliant overnight. The integration runs /listing_violation filtered to compliance_type=ITEM_SPECIFICS, groups the results by category, and feeds them into a bulk update job that fills the missing aspect via the Sell Inventory API.

Pull /listing_violation with compliance_type=ITEM_SPECIFICS, group by primaryCategoryId, and produce one Inventory API update payload per category

AI agent integration via Jentic

An AI agent that polices a seller's catalogue searches Jentic for 'list eBay listings with compliance violations'. Jentic returns the /listing_violation operation, the agent loads its schema, and executes the call with a User access token issued through Jentic's vault. For each violation, the agent reads the recommendedAction string and proposes a fix that the seller can accept or reject in chat.

Use Jentic to search 'list eBay listings with compliance violations', load /listing_violation, and execute it; for each entry, generate a one-line summary of the recommendedAction

Key Endpoints

2 endpoints — the ebay sell compliance api tells sellers which of their active listings violate, or are at risk of violating, ebay listing policies — restricted-item rules, missing item specifics, image quality, brand-protection flags, regional take-back disclosures, and others.

METHOD

PATH

DESCRIPTION

GET

/listing_violation_summary

Get a count of compliance violations grouped by type

GET

/listing_violation

Get per-listing compliance violation detail with recommended fixes

GET

/listing_violation_summary

Get a count of compliance violations grouped by type

GET

/listing_violation

Get per-listing compliance violation detail with recommended fixes

Why though Jentic?

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

Credential isolation

eBay OAuth 2.0 User refresh tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive a scoped access token for the sell.compliance.readonly scope only — the refresh token, client secret, and seller OAuth consent never enter the agent's context.

Intent-based discovery

Agents search by intent (e.g., 'find eBay listings with compliance violations') and Jentic returns the /listing_violation or /listing_violation_summary operation with the right input schema, so the agent calls the appropriate endpoint without parsing eBay's seller documentation.

Time to first call

Direct integration: 2-3 days for OAuth Authorization Code flow plus pagination and compliance_type filtering. Through Jentic: under 30 minutes — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

eBay Sell Account API

Sell Account fixes the underlying policy when a Sell Compliance violation points at one.

When Sell Compliance reports a policy-related violation (e.g., return-policy gap), use Sell Account to update or replace the offending policy.

Complementary

eBay Sell Analytics API

Sell Analytics tracks the resulting traffic loss when listings get demoted for compliance reasons.

Pair Sell Compliance with Sell Analytics to confirm that fixing flagged listings recovers the lost impressions.

Complementary

eBay Browse API

Browse shows the buyer-facing version of a listing flagged by Sell Compliance.

When triaging a violation, use Browse /item/{item_id} to see exactly what the buyer is seeing while the listing is at risk.

FAQs

Specific to using Sell Compliance API API through Jentic.

What authentication does the Sell Compliance API use?

The Sell Compliance API uses OAuth 2.0 with the Authorization Code grant — both endpoints run in the seller's context, so a User access token is required. Through Jentic, the seller's refresh token sits in the MAXsystem vault and the agent receives only a scoped access token for the sell.compliance.readonly scope.

Can I see exactly which listings violate a policy with the Sell Compliance API?

Yes. /listing_violation returns one entry per offending listingId with the compliance_type, the violation reason, the violationStatus (AT_RISK or NON_COMPLIANT), and a recommendedAction string describing the fix. Filter the call by compliance_type to focus on a single rule set.

What are the rate limits for the Sell Compliance API?

Sell Compliance falls under the Sell APIs user-context daily quota issued per application-and-user pair. Call /user_rate_limit on the Developer Analytics API and inspect the sell.compliance entry to read the live remaining count for the authenticated seller.

How do I poll for at-risk listings through Jentic?

Search Jentic for 'list eBay listings with compliance violations', load GET /listing_violation, and execute it with filter 'violationStatus:AT_RISK'. Run it on a schedule (daily is typical). Install with pip install jentic. Sign up at https://app.jentic.com/sign-up.

What compliance_type values does the API report?

Common values include RESTRICTED_ITEM, MISSING_PHOTO, ITEM_SPECIFICS, PRODUCT_ADOPTION, CATEGORY_PLACEMENT, BRAND_PROTECTION, and BUYER_ABUSE_DEFLECTION. The full enumeration is published per marketplace and can change as eBay introduces new policy categories — check the response field rather than hard-coding the list.

Does fixing a listing remove it from /listing_violation immediately?

Updates flow through eBay's compliance evaluation pipeline, which typically refreshes within minutes to hours after a Sell Inventory API update. Treat /listing_violation as eventually consistent — re-poll after the fix to confirm the violation has cleared.