AMC Theatres API — Concessions

naftiko: 1.0.0-alpha2
info:
  label: AMC Theatres API — Concessions
  description: 'AMC Theatres API — Concessions. 8 operations. Lead operation: Get Concession By Theatre Product Assignment
    Id. Self-contained Naftiko capability covering one Amc Entertainment Holdings business surface.'
  tags:
  - Amc Entertainment Holdings
  - Concessions
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    AMC_ENTERTAINMENT_HOLDINGS_API_KEY: AMC_ENTERTAINMENT_HOLDINGS_API_KEY
capability:
  consumes:
  - type: http
    namespace: amc-theatres-concessions
    baseUri: https://api.amctheatres.com
    description: AMC Theatres API — Concessions business capability. Self-contained, no shared references.
    resources:
    - name: v1-concessions-theatre-product-assignment-id
      path: /v1/concessions/{theatre-product-assignment-id}
      operations:
      - name: getconcessionbyassignment
        method: GET
        description: Get Concession By Theatre Product Assignment Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: theatre-product-assignment-id
          in: path
          type: integer
          required: true
    - name: v1-showtimes-id-concession-delivery-times
      path: /v1/showtimes/{id}/concession-delivery-times
      operations:
      - name: listshowtimeconcessiondeliverytimes
        method: GET
        description: List Concession Delivery Times For Showtime
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
    - name: v1-showtimes-showtime-id-concession-pickup-times
      path: /v1/showtimes/{showtime-id}/concession-pickup-times
      operations:
      - name: listshowtimeconcessionpickuptimes
        method: GET
        description: List Concession Pickup Times For Showtime
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: showtime-id
          in: path
          type: integer
          required: true
    - name: v1-theatres-theatre-id-concessions
      path: /v1/theatres/{theatre-id}/concessions
      operations:
      - name: listtheatreconcessions
        method: GET
        description: List Concessions For a Theatre
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: theatre-id
          in: path
          type: integer
          required: true
    - name: v1-theatres-theatre-id-concessions-categories
      path: /v1/theatres/{theatre-id}/concessions/categories
      operations:
      - name: listconcessioncategories
        method: GET
        description: List Concession Categories For a Theatre
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: theatre-id
          in: path
          type: integer
          required: true
    - name: v1-theatres-theatre-id-concessions-delivery-locations-year-month-day
      path: /v1/theatres/{theatre-id}/concessions/delivery-locations/{year}/{month}/{day}
      operations:
      - name: listconcessiondeliverylocations
        method: GET
        description: List Concession Delivery Locations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: theatre-id
          in: path
          type: integer
          required: true
        - name: year
          in: path
          type: integer
          required: true
        - name: month
          in: path
          type: integer
          required: true
        - name: day
          in: path
          type: integer
          required: true
    - name: v1-theatres-theatre-id-concessions-pickup-times-year-month-day
      path: /v1/theatres/{theatre-id}/concessions/pickup-times/{year}/{month}/{day}
      operations:
      - name: listconcessionpickuptimes
        method: GET
        description: List Concession Pickup Times
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: theatre-id
          in: path
          type: integer
          required: true
        - name: year
          in: path
          type: integer
          required: true
        - name: month
          in: path
          type: integer
          required: true
        - name: day
          in: path
          type: integer
          required: true
    - name: v1-theatres-theatre-id-concessions-concession-id
      path: /v1/theatres/{theatre-id}/concessions/{concession-id}
      operations:
      - name: getconcession
        method: GET
        description: Get Concession By Theatre and Concession Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: theatre-id
          in: path
          type: integer
          required: true
        - name: concession-id
          in: path
          type: integer
          required: true
    authentication:
      type: apikey
      key: X-AMC-Vendor-Key
      value: '{{env.AMC_ENTERTAINMENT_HOLDINGS_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: amc-theatres-concessions-rest
    port: 8080
    description: REST adapter for AMC Theatres API — Concessions. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v1/concessions/{theatre-product-assignment-id}
      name: v1-concessions-theatre-product-assignment-id
      description: REST surface for v1-concessions-theatre-product-assignment-id.
      operations:
      - method: GET
        name: getconcessionbyassignment
        description: Get Concession By Theatre Product Assignment Id
        call: amc-theatres-concessions.getconcessionbyassignment
        with:
          theatre-product-assignment-id: rest.theatre-product-assignment-id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/showtimes/{id}/concession-delivery-times
      name: v1-showtimes-id-concession-delivery-times
      description: REST surface for v1-showtimes-id-concession-delivery-times.
      operations:
      - method: GET
        name: listshowtimeconcessiondeliverytimes
        description: List Concession Delivery Times For Showtime
        call: amc-theatres-concessions.listshowtimeconcessiondeliverytimes
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/showtimes/{showtime-id}/concession-pickup-times
      name: v1-showtimes-showtime-id-concession-pickup-times
      description: REST surface for v1-showtimes-showtime-id-concession-pickup-times.
      operations:
      - method: GET
        name: listshowtimeconcessionpickuptimes
        description: List Concession Pickup Times For Showtime
        call: amc-theatres-concessions.listshowtimeconcessionpickuptimes
        with:
          showtime-id: rest.showtime-id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/theatres/{theatre-id}/concessions
      name: v1-theatres-theatre-id-concessions
      description: REST surface for v1-theatres-theatre-id-concessions.
      operations:
      - method: GET
        name: listtheatreconcessions
        description: List Concessions For a Theatre
        call: amc-theatres-concessions.listtheatreconcessions
        with:
          theatre-id: rest.theatre-id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/theatres/{theatre-id}/concessions/categories
      name: v1-theatres-theatre-id-concessions-categories
      description: REST surface for v1-theatres-theatre-id-concessions-categories.
      operations:
      - method: GET
        name: listconcessioncategories
        description: List Concession Categories For a Theatre
        call: amc-theatres-concessions.listconcessioncategories
        with:
          theatre-id: rest.theatre-id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/theatres/{theatre-id}/concessions/delivery-locations/{year}/{month}/{day}
      name: v1-theatres-theatre-id-concessions-delivery-locations-year-month-day
      description: REST surface for v1-theatres-theatre-id-concessions-delivery-locations-year-month-day.
      operations:
      - method: GET
        name: listconcessiondeliverylocations
        description: List Concession Delivery Locations
        call: amc-theatres-concessions.listconcessiondeliverylocations
        with:
          theatre-id: rest.theatre-id
          year: rest.year
          month: rest.month
          day: rest.day
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/theatres/{theatre-id}/concessions/pickup-times/{year}/{month}/{day}
      name: v1-theatres-theatre-id-concessions-pickup-times-year-month-day
      description: REST surface for v1-theatres-theatre-id-concessions-pickup-times-year-month-day.
      operations:
      - method: GET
        name: listconcessionpickuptimes
        description: List Concession Pickup Times
        call: amc-theatres-concessions.listconcessionpickuptimes
        with:
          theatre-id: rest.theatre-id
          year: rest.year
          month: rest.month
          day: rest.day
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/theatres/{theatre-id}/concessions/{concession-id}
      name: v1-theatres-theatre-id-concessions-concession-id
      description: REST surface for v1-theatres-theatre-id-concessions-concession-id.
      operations:
      - method: GET
        name: getconcession
        description: Get Concession By Theatre and Concession Id
        call: amc-theatres-concessions.getconcession
        with:
          theatre-id: rest.theatre-id
          concession-id: rest.concession-id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: amc-theatres-concessions-mcp
    port: 9090
    transport: http
    description: MCP adapter for AMC Theatres API — Concessions. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: get-concession-theatre-product-assignment
      description: Get Concession By Theatre Product Assignment Id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amc-theatres-concessions.getconcessionbyassignment
      with:
        theatre-product-assignment-id: tools.theatre-product-assignment-id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-concession-delivery-times-showtime
      description: List Concession Delivery Times For Showtime
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amc-theatres-concessions.listshowtimeconcessiondeliverytimes
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-concession-pickup-times-showtime
      description: List Concession Pickup Times For Showtime
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amc-theatres-concessions.listshowtimeconcessionpickuptimes
      with:
        showtime-id: tools.showtime-id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-concessions-theatre
      description: List Concessions For a Theatre
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amc-theatres-concessions.listtheatreconcessions
      with:
        theatre-id: tools.theatre-id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-concession-categories-theatre
      description: List Concession Categories For a Theatre
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amc-theatres-concessions.listconcessioncategories
      with:
        theatre-id: tools.theatre-id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-concession-delivery-locations
      description: List Concession Delivery Locations
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amc-theatres-concessions.listconcessiondeliverylocations
      with:
        theatre-id: tools.theatre-id
        year: tools.year
        month: tools.month
        day: tools.day
      outputParameters:
      - type: object
        mapping: $.
    - name: list-concession-pickup-times
      description: List Concession Pickup Times
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amc-theatres-concessions.listconcessionpickuptimes
      with:
        theatre-id: tools.theatre-id
        year: tools.year
        month: tools.month
        day: tools.day
      outputParameters:
      - type: object
        mapping: $.
    - name: get-concession-theatre-and-concession
      description: Get Concession By Theatre and Concession Id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amc-theatres-concessions.getconcession
      with:
        theatre-id: tools.theatre-id
        concession-id: tools.concession-id
      outputParameters:
      - type: object
        mapping: $.