eBay Deal API — Event

naftiko: 1.0.0-alpha2
info:
  label: eBay Deal API — Event
  description: 'eBay Deal API — Event. 2 operations. Lead operation: Event. Self-contained Naftiko capability covering one
    Ebay business surface.'
  tags:
  - Ebay
  - Event
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    EBAY_API_KEY: EBAY_API_KEY
capability:
  consumes:
  - type: http
    namespace: deal-event
    baseUri: https://api.ebay.com{basePath}
    description: eBay Deal API — Event business capability. Self-contained, no shared references.
    resources:
    - name: event
      path: /event
      operations:
      - name: getevents
        method: GET
        description: This method returns paginated results containing all eBay events for the specified marketplace.<h3><b>Restrictions
          </b></h3>This method can return a maximum of 10,000 items. For a list of supported sites and other restrictions,
          see <a href=
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The maximum number of items, from the current result set, returned on a single page.<br /><br /><b>Default:</b>
            <code>20</code><br /><br /><b>Maximum Value:</b>
        - name: offset
          in: query
          type: string
          description: The number of items that will be skipped in the result set. This is used with the <b>limit</b> field
            to control the pagination of the output.<br /><br />For exa
        - name: X-EBAY-C-MARKETPLACE-ID
          in: header
          type: string
          description: This header identifies the eBay marketplace.<br><br>See <a href="/api-docs/static/rest-request-components.html#marketpl
            " target="_blank ">HTTP request headers<
          required: true
        - name: X-EBAY-C-ENDUSERCTX
          in: header
          type: string
          description: This header is required to support revenue sharing for eBay Partner Network and to improve the accuracy
            of shipping and delivery time estimations.<br><br>For ad
    - name: event-event_id
      path: /event/{event_id}
      operations:
      - name: getevent
        method: GET
        description: This method retrieves the details for an eBay event. The result set contains detailed information associated
          with the specified event ID, such as applicable coupons, start and end dates, and event terms.<h3><b>Restrictions
          </b></h3>This met
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-EBAY-C-MARKETPLACE-ID
          in: header
          type: string
          description: This header identifies the eBay marketplace.<br><br>See <a href="/api-docs/static/rest-request-components.html#marketpl
            " target="_blank ">HTTP request headers<
          required: true
        - name: X-EBAY-C-ENDUSERCTX
          in: header
          type: string
          description: This header is required to support revenue sharing for eBay Partner Network and to improve the accuracy
            of shipping and delivery time estimations.<br><br>For ad
        - name: event_id
          in: path
          type: string
          description: This path parameters specifies the unique identifier for the eBay event being retrieved.<br><br>Use
            the <a href="/api-docs/buy/deal/resources/event/methods/getE
          required: true
    authentication:
      type: bearer
      token: '{{env.EBAY_API_KEY}}'
  exposes:
  - type: rest
    namespace: deal-event-rest
    port: 8080
    description: REST adapter for eBay Deal API — Event. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/event
      name: event
      description: REST surface for event.
      operations:
      - method: GET
        name: getevents
        description: This method returns paginated results containing all eBay events for the specified marketplace.<h3><b>Restrictions
          </b></h3>This method can return a maximum of 10,000 items. For a list of supported sites and other restrictions,
          see <a href=
        call: deal-event.getevents
        with:
          limit: rest.limit
          offset: rest.offset
          X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
          X-EBAY-C-ENDUSERCTX: rest.X-EBAY-C-ENDUSERCTX
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/event/{event-id}
      name: event-event-id
      description: REST surface for event-event_id.
      operations:
      - method: GET
        name: getevent
        description: This method retrieves the details for an eBay event. The result set contains detailed information associated
          with the specified event ID, such as applicable coupons, start and end dates, and event terms.<h3><b>Restrictions
          </b></h3>This met
        call: deal-event.getevent
        with:
          X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
          X-EBAY-C-ENDUSERCTX: rest.X-EBAY-C-ENDUSERCTX
          event_id: rest.event_id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: deal-event-mcp
    port: 9090
    transport: http
    description: MCP adapter for eBay Deal API — Event. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: this-method-returns-paginated-results
      description: This method returns paginated results containing all eBay events for the specified marketplace.<h3><b>Restrictions
        </b></h3>This method can return a maximum of 10,000 items. For a list of supported sites and other restrictions, see
        <a href=
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: deal-event.getevents
      with:
        limit: tools.limit
        offset: tools.offset
        X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
        X-EBAY-C-ENDUSERCTX: tools.X-EBAY-C-ENDUSERCTX
      outputParameters:
      - type: object
        mapping: $.
    - name: this-method-retrieves-details-ebay
      description: This method retrieves the details for an eBay event. The result set contains detailed information associated
        with the specified event ID, such as applicable coupons, start and end dates, and event terms.<h3><b>Restrictions
        </b></h3>This met
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: deal-event.getevent
      with:
        X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
        X-EBAY-C-ENDUSERCTX: tools.X-EBAY-C-ENDUSERCTX
        event_id: tools.event_id
      outputParameters:
      - type: object
        mapping: $.