AMC Theatres API — Orders

naftiko: 1.0.0-alpha2
info:
  label: AMC Theatres API — Orders
  description: 'AMC Theatres API — Orders. 19 operations. Lead operation: List Orders For AMC Account. Self-contained Naftiko
    capability covering one Amc Entertainment Holdings business surface.'
  tags:
  - Amc Entertainment Holdings
  - Orders
  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-orders
    baseUri: https://api.amctheatres.com
    description: AMC Theatres API — Orders business capability. Self-contained, no shared references.
    resources:
    - name: v3-amc-accounts-account-id-orders
      path: /v3/amc-accounts/{account-id}/orders/
      operations:
      - name: listaccountorders
        method: GET
        description: List Orders For AMC Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-orders
      path: /v3/orders
      operations:
      - name: createorder
        method: POST
        description: Create Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v3-orders-record
      path: /v3/orders/record
      operations:
      - name: recordorder
        method: POST
        description: Record Completed Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v3-orders-token-{token}
      path: /v3/orders/token-{token}
      operations:
      - name: getorderbytoken
        method: GET
        description: Get Order By Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: token
          in: path
          type: string
          required: true
    - name: v3-orders-order-id
      path: /v3/orders/{order-id}
      operations:
      - name: getorder
        method: GET
        description: Get Order By Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateordercontact
        method: PUT
        description: Update Order Contact Info
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleteorder
        method: DELETE
        description: Delete Order By Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-orders-order-id-email-{email}
      path: /v3/orders/{order-id}/email-{email}/
      operations:
      - name: getorderbyidandemail
        method: GET
        description: Lookup Order By Id and Email
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: email
          in: path
          type: string
          required: true
    - name: v3-orders-order-id-failed-payment-auths
      path: /v3/orders/{order-id}/failed-payment-auths
      operations:
      - name: recordfailedpaymentauth
        method: POST
        description: Record Failed Payment Authorization
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v3-orders-order-id-loyalty-rewards-application
      path: /v3/orders/{order-id}/loyalty-rewards-application
      operations:
      - name: applyloyaltyrewards
        method: POST
        description: Apply Loyalty Rewards To Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: removeloyaltyrewards
        method: DELETE
        description: Remove Loyalty Rewards From Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-orders-order-id-payments
      path: /v3/orders/{order-id}/payments
      operations:
      - name: addorderpayment
        method: POST
        description: Add Payment To Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v3-orders-order-id-payments-line-number
      path: /v3/orders/{order-id}/payments/{line-number}
      operations:
      - name: deleteorderpayment
        method: DELETE
        description: Delete Payment From Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: line-number
          in: path
          type: integer
          required: true
    - name: v3-orders-order-id-products
      path: /v3/orders/{order-id}/products
      operations:
      - name: addorderproduct
        method: POST
        description: Add Product To Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v3-orders-order-id-products-line-number
      path: /v3/orders/{order-id}/products/{line-number}
      operations:
      - name: updateorderproduct
        method: PUT
        description: Update Product in Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: patchorderproduct
        method: PATCH
        description: Patch Product Delivery Info
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleteorderproduct
        method: DELETE
        description: Delete Product From Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-orders-order-id-products-line-number-sms-ticket-confirmation-phone-number
      path: /v3/orders/{order-id}/products/{line-number}/sms-ticket-confirmation/{phone-number}
      operations:
      - name: sendticketconfirmationsms
        method: POST
        description: Send Ticket Confirmation SMS
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: line-number
          in: path
          type: integer
          required: true
        - name: phone-number
          in: path
          type: string
          required: true
    - name: v3-orders-order-id-refresh-expiration
      path: /v3/orders/{order-id}/refresh-expiration
      operations:
      - name: refreshorderexpiration
        method: POST
        description: Refresh Order Expiration
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: X-AMC-Vendor-Key
      value: '{{env.AMC_ENTERTAINMENT_HOLDINGS_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: amc-theatres-orders-rest
    port: 8080
    description: REST adapter for AMC Theatres API — Orders. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/v3/amc-accounts/{account-id}/orders
      name: v3-amc-accounts-account-id-orders
      description: REST surface for v3-amc-accounts-account-id-orders.
      operations:
      - method: GET
        name: listaccountorders
        description: List Orders For AMC Account
        call: amc-theatres-orders.listaccountorders
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/orders
      name: v3-orders
      description: REST surface for v3-orders.
      operations:
      - method: POST
        name: createorder
        description: Create Order
        call: amc-theatres-orders.createorder
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/orders/record
      name: v3-orders-record
      description: REST surface for v3-orders-record.
      operations:
      - method: POST
        name: recordorder
        description: Record Completed Order
        call: amc-theatres-orders.recordorder
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/orders/token-token
      name: v3-orders-token-token
      description: REST surface for v3-orders-token-{token}.
      operations:
      - method: GET
        name: getorderbytoken
        description: Get Order By Token
        call: amc-theatres-orders.getorderbytoken
        with:
          token: rest.token
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/orders/{order-id}
      name: v3-orders-order-id
      description: REST surface for v3-orders-order-id.
      operations:
      - method: GET
        name: getorder
        description: Get Order By Id
        call: amc-theatres-orders.getorder
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updateordercontact
        description: Update Order Contact Info
        call: amc-theatres-orders.updateordercontact
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteorder
        description: Delete Order By Id
        call: amc-theatres-orders.deleteorder
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/orders/{order-id}/email-email
      name: v3-orders-order-id-email-email
      description: REST surface for v3-orders-order-id-email-{email}.
      operations:
      - method: GET
        name: getorderbyidandemail
        description: Lookup Order By Id and Email
        call: amc-theatres-orders.getorderbyidandemail
        with:
          email: rest.email
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/orders/{order-id}/failed-payment-auths
      name: v3-orders-order-id-failed-payment-auths
      description: REST surface for v3-orders-order-id-failed-payment-auths.
      operations:
      - method: POST
        name: recordfailedpaymentauth
        description: Record Failed Payment Authorization
        call: amc-theatres-orders.recordfailedpaymentauth
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/orders/{order-id}/loyalty-rewards-application
      name: v3-orders-order-id-loyalty-rewards-application
      description: REST surface for v3-orders-order-id-loyalty-rewards-application.
      operations:
      - method: POST
        name: applyloyaltyrewards
        description: Apply Loyalty Rewards To Order
        call: amc-theatres-orders.applyloyaltyrewards
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: removeloyaltyrewards
        description: Remove Loyalty Rewards From Order
        call: amc-theatres-orders.removeloyaltyrewards
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/orders/{order-id}/payments
      name: v3-orders-order-id-payments
      description: REST surface for v3-orders-order-id-payments.
      operations:
      - method: POST
        name: addorderpayment
        description: Add Payment To Order
        call: amc-theatres-orders.addorderpayment
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/orders/{order-id}/payments/{line-number}
      name: v3-orders-order-id-payments-line-number
      description: REST surface for v3-orders-order-id-payments-line-number.
      operations:
      - method: DELETE
        name: deleteorderpayment
        description: Delete Payment From Order
        call: amc-theatres-orders.deleteorderpayment
        with:
          line-number: rest.line-number
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/orders/{order-id}/products
      name: v3-orders-order-id-products
      description: REST surface for v3-orders-order-id-products.
      operations:
      - method: POST
        name: addorderproduct
        description: Add Product To Order
        call: amc-theatres-orders.addorderproduct
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/orders/{order-id}/products/{line-number}
      name: v3-orders-order-id-products-line-number
      description: REST surface for v3-orders-order-id-products-line-number.
      operations:
      - method: PUT
        name: updateorderproduct
        description: Update Product in Order
        call: amc-theatres-orders.updateorderproduct
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: patchorderproduct
        description: Patch Product Delivery Info
        call: amc-theatres-orders.patchorderproduct
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteorderproduct
        description: Delete Product From Order
        call: amc-theatres-orders.deleteorderproduct
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/orders/{order-id}/products/{line-number}/sms-ticket-confirmation/{phone-number}
      name: v3-orders-order-id-products-line-number-sms-ticket-confirmation-phone-number
      description: REST surface for v3-orders-order-id-products-line-number-sms-ticket-confirmation-phone-number.
      operations:
      - method: POST
        name: sendticketconfirmationsms
        description: Send Ticket Confirmation SMS
        call: amc-theatres-orders.sendticketconfirmationsms
        with:
          line-number: rest.line-number
          phone-number: rest.phone-number
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/orders/{order-id}/refresh-expiration
      name: v3-orders-order-id-refresh-expiration
      description: REST surface for v3-orders-order-id-refresh-expiration.
      operations:
      - method: POST
        name: refreshorderexpiration
        description: Refresh Order Expiration
        call: amc-theatres-orders.refreshorderexpiration
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: amc-theatres-orders-mcp
    port: 9090
    transport: http
    description: MCP adapter for AMC Theatres API — Orders. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: list-orders-amc-account
      description: List Orders For AMC Account
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amc-theatres-orders.listaccountorders
      outputParameters:
      - type: object
        mapping: $.
    - name: create-order
      description: Create Order
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: amc-theatres-orders.createorder
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: record-completed-order
      description: Record Completed Order
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: amc-theatres-orders.recordorder
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-order-token
      description: Get Order By Token
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amc-theatres-orders.getorderbytoken
      with:
        token: tools.token
      outputParameters:
      - type: object
        mapping: $.
    - name: get-order-id
      description: Get Order By Id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amc-theatres-orders.getorder
      outputParameters:
      - type: object
        mapping: $.
    - name: update-order-contact-info
      description: Update Order Contact Info
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: amc-theatres-orders.updateordercontact
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-order-id
      description: Delete Order By Id
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: amc-theatres-orders.deleteorder
      outputParameters:
      - type: object
        mapping: $.
    - name: lookup-order-id-and-email
      description: Lookup Order By Id and Email
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amc-theatres-orders.getorderbyidandemail
      with:
        email: tools.email
      outputParameters:
      - type: object
        mapping: $.
    - name: record-failed-payment-authorization
      description: Record Failed Payment Authorization
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: amc-theatres-orders.recordfailedpaymentauth
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: apply-loyalty-rewards-order
      description: Apply Loyalty Rewards To Order
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: amc-theatres-orders.applyloyaltyrewards
      outputParameters:
      - type: object
        mapping: $.
    - name: remove-loyalty-rewards-order
      description: Remove Loyalty Rewards From Order
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: amc-theatres-orders.removeloyaltyrewards
      outputParameters:
      - type: object
        mapping: $.
    - name: add-payment-order
      description: Add Payment To Order
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: amc-theatres-orders.addorderpayment
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-payment-order
      description: Delete Payment From Order
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: amc-theatres-orders.deleteorderpayment
      with:
        line-number: tools.line-number
      outputParameters:
      - type: object
        mapping: $.
    - name: add-product-order
      description: Add Product To Order
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: amc-theatres-orders.addorderproduct
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: update-product-order
      description: Update Product in Order
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: amc-theatres-orders.updateorderproduct
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: patch-product-delivery-info
      description: Patch Product Delivery Info
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: amc-theatres-orders.patchorderproduct
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-product-order
      description: Delete Product From Order
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: amc-theatres-orders.deleteorderproduct
      outputParameters:
      - type: object
        mapping: $.
    - name: send-ticket-confirmation-sms
      description: Send Ticket Confirmation SMS
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: amc-theatres-orders.sendticketconfirmationsms
      with:
        line-number: tools.line-number
        phone-number: tools.phone-number
      outputParameters:
      - type: object
        mapping: $.
    - name: refresh-order-expiration
      description: Refresh Order Expiration
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: amc-theatres-orders.refreshorderexpiration
      outputParameters:
      - type: object
        mapping: $.