eBay Compliance API — Listing_violation

naftiko: 1.0.0-alpha2
info:
  label: eBay Compliance API — Listing_violation
  description: 'eBay Compliance API — Listing_violation. 1 operations. Lead operation: Listing_violation. Self-contained Naftiko
    capability covering one Ebay business surface.'
  tags:
  - Ebay
  - Listing_violation
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    EBAY_API_KEY: EBAY_API_KEY
capability:
  consumes:
  - type: http
    namespace: compliance-listing-violation
    baseUri: https://api.ebay.com{basePath}
    description: eBay Compliance API — Listing_violation business capability. Self-contained, no shared references.
    resources:
    - name: listing_violation
      path: /listing_violation
      operations:
      - name: getlistingviolations
        method: GET
        description: This call returns specific listing violations for the supported listing compliance types. Only one compliance
          type can be passed in per call, and the response will include all the listing violations for this compliance type,
          and listing vio
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-EBAY-C-MARKETPLACE-ID
          in: header
          type: string
          description: 'This header identifies the seller''s eBay marketplace. <br><br>Supported values for this header can
            be found in the <a href="/api-docs/sell/compliance/types/bas:'
          required: true
        - name: compliance_type
          in: query
          type: string
          description: This query parameter specifies the compliance type of the listing violations being retrieved. Only
            one compliance type value can be specified. <br> <br>See <a h
          required: true
        - name: offset
          in: query
          type: string
          description: The integer value input into this field controls the first listing violation in the result set that
            will be displayed at the top of the response. The <strong>of
        - name: listing_id
          in: query
          type: string
          description: <span class="tablenote"><strong>Note:</strong> This query parameter is not yet supported for the Compliance
            API.</span>
        - name: limit
          in: query
          type: string
          description: This query parameter is used if the user wants to set a limit on the number of listing violations that
            are returned on one page of the result set. This paramete
        - name: filter
          in: query
          type: string
          description: This filter allows a user to retrieve only listings that are currently out of compliance, or only listings
            that are at risk of becoming out of compliance.<br><b
    authentication:
      type: bearer
      token: '{{env.EBAY_API_KEY}}'
  exposes:
  - type: rest
    namespace: compliance-listing-violation-rest
    port: 8080
    description: REST adapter for eBay Compliance API — Listing_violation. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/listing-violation
      name: listing-violation
      description: REST surface for listing_violation.
      operations:
      - method: GET
        name: getlistingviolations
        description: This call returns specific listing violations for the supported listing compliance types. Only one compliance
          type can be passed in per call, and the response will include all the listing violations for this compliance type,
          and listing vio
        call: compliance-listing-violation.getlistingviolations
        with:
          X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
          compliance_type: rest.compliance_type
          offset: rest.offset
          listing_id: rest.listing_id
          limit: rest.limit
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: compliance-listing-violation-mcp
    port: 9090
    transport: http
    description: MCP adapter for eBay Compliance API — Listing_violation. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: this-call-returns-specific-listing
      description: This call returns specific listing violations for the supported listing compliance types. Only one compliance
        type can be passed in per call, and the response will include all the listing violations for this compliance type,
        and listing vio
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: compliance-listing-violation.getlistingviolations
      with:
        X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
        compliance_type: tools.compliance_type
        offset: tools.offset
        listing_id: tools.listing_id
        limit: tools.limit
        filter: tools.filter
      outputParameters:
      - type: object
        mapping: $.