JPMorgan Chase

JPMorgan Chase Subscriptions API

Manage notification subscriptions

GitHub OpenAPI

Operations 7

GET /subscriptions Get all subscriptions by entity Id #
POST /subscriptions Subscribe to a notification #
GET /subscriptions/{subscription-id} Get a subscription by subscription Id #
PUT /subscriptions/{subscription-id} Update a specific subscription #
DELETE /subscriptions/{subscription-id} Delete a specific subscription #
GET /publicKeys (***DEPRECATED***) Get a public key by entity Id #
GET /subscriptions/verifications/{id} Get pending subscription verification by request id

Documentation

📖
Documentation
https://developer.payments.jpmorgan.com/api
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fembedded-finance-solutions%2Fembedded-payments%2Fonboarding-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Foptimization-protection%2Fconsumer-profile%2Fconsumer-profile-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Foptimization-protection%2Ftokenization%2Ftokenization-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Foptimization-protection%2Freporting%2Freporting-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Ftreasury%2Freceivables%2Frequest-to-pay-api.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Fonline-payments%2Fcheckout%2Fcheckout-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Fdispute-management%2Fdispute-management-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Ffraud-solutions%2Falerts-and-decisioning%2Foas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Fproduct-configuration%2Fproduct-configuration-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Foptimization-protection%2F3-d-secure%2F3-d-secure-1.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Foptimization-protection%2Faccount-updater%2Faccount-updater-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Ftreasury%2Fglobal-payments%2Fglobal-payments%2Fglobal-payments-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fliquidity-account-solutions%2Fbda-balances%2Faccounts-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Ffraud-solutions%2Fvalidation-services%2Fvalidation-services-oas.md
📖
APIReference
https://developer.payments.jpmorgan.com/api/llm-content?path=en%2Fapi%2Fcommerce%2Foptimization-protection%2Fwallet-decryption%2Fwallet-decryption-oas.md

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/jp-morgan-chase/refs/heads/main/openapi/jp-morgan-chase-subscriptions-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/jp-morgan-chase-subscriptions-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jp-morgan-chase-subscriptions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Notifications Subscriptions API
  description: Notification API enables merchants to subscribe to and receive notifications in real-time.
  version: 1.13.1
  contact:
    name: Notifications API Support
    url: https://developer.payments.jpmorgan.com/contact/support
servers:
- url: https://mns-aws.jpmchase.com/v1
  description: PRODUCTION - OAUTH
- url: https://mns-aws-cat.jpmchase.com/v1
  description: CLIENT TESTING - OAUTH
- url: https://api-mock.payments.jpmorgan.com/v1
  description: MOCK
security:
- BearerAuth: []
tags:
- name: Subscriptions
  description: Manage notification subscriptions
paths:
  /subscriptions:
    get:
      summary: Get all subscriptions by entity Id
      operationId: v1ListSubscriptions
      tags:
      - Subscriptions
      description: Retrieves all subscriptions using the entity Id
      parameters:
      - name: merchant-id
        in: header
        deprecated: true
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifier for the merchant account.
        examples:
          Success:
            value: '9876543210'
          Authentication failure:
            value: '9876543211'
          Authorization failure:
            value: '9876543212'
      - name: entity-id
        in: header
        required: true
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifier for the entity.
        examples:
          Success:
            value: '9876543210'
          Authentication failure:
            value: '9876543211'
          Authorization failure:
            value: '9876543212'
      - name: entity-type
        in: header
        required: true
        schema:
          type: string
          enum:
          - MERCHANT
          - PLATFORM
          - CLIENT
          - ACCOUNT
          - EMBEDDED_PLATFORM
          - CONSUMER
        description: Type of entity  identifier.
      - name: request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
        description: A unique identifier provided by the requestor for each request.
        examples:
          Success:
            value: 7611d1bf-325c-4795-a828-ac21f9bea5dc
          Authentication failure:
            value: 7611d1bf-325c-4795-a828-ac21f9bea7ab
          Authorization failure:
            value: 7611d1bf-325c-4795-a828-ac21f9bea8dc
      - name: notification-type
        in: header
        schema:
          type: string
        description: The first level categories of events the firm uses to communicate with the merchant.
      - name: parent-entity-id
        in: header
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifies the Parent Entity in the merchant hierarchy applicable to this request (e.g. platform ID in ISV use cases).
        examples:
          Success:
            value: 0123456797
          Authentication failure:
            value: 0123456798
          Authorization failure:
            value: 0123456799
      - name: parent-entity-type
        in: header
        schema:
          type: string
          enum:
          - PLATFORM
          - EMBEDDED_PLATFORM
        description: Code for the Parent Entity Type in the merchant hierarchy applicable to this request (e.g. platform in ISV use cases).
      - name: email-address
        in: header
        schema:
          type: string
        description: A mail system that allows a party to send and receive messages electronically. An email address is composed of a local part and a domain part. The local part is unique to the individual while the domain or host name must meet specific standards required by the host that administers the email service.
      - name: subscription-category
        in: header
        schema:
          type: string
        description: Delineates a set of rules for the management of a subscription.
      - name: subscription-channel
        in: header
        schema:
          type: string
        description: Codifies the method in which the Firm communicates with the Party.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/subscriptionResponseList'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/adfsError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '504':
          description: Gateway Timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
    post:
      summary: Subscribe to a notification
      operationId: v1CreateSubscription
      tags:
      - Subscriptions
      description: Create subscriptions to notification event types
      parameters:
      - name: merchant-id
        in: header
        deprecated: true
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifier for the merchant account.
        examples:
          Success:
            value: '9876543210'
          Authentication failure:
            value: '9876543211'
          Authorization failure:
            value: '9876543212'
      - name: entity-id
        in: header
        required: true
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifier for the entity.
        examples:
          Success:
            value: '9876543210'
          Authentication failure:
            value: '9876543211'
          Authorization failure:
            value: '9876543212'
      - name: request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
        description: A unique identifier provided by the requestor for each request.
        examples:
          Success:
            value: 7611d1bf-325c-4795-a828-ac21f9bea5dc
          Authentication failure:
            value: 7611d1bf-325c-4795-a828-ac21f9bea7ab
          Authorization failure:
            value: 7611d1bf-325c-4795-a828-ac21f9bea8dc
      - name: entity-type
        in: header
        required: true
        schema:
          type: string
          enum:
          - MERCHANT
          - PLATFORM
          - CLIENT
          - ACCOUNT
          - EMBEDDED_PLATFORM
          - CONSUMER
        description: Type of entity  identifier.
      - name: parent-entity-id
        in: header
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifies the Parent Entity in the merchant hierarchy applicable to this request (e.g. platform ID in ISV use cases).
        examples:
          Success:
            value: 0123456797
          Authentication failure:
            value: 0123456798
          Authorization failure:
            value: 0123456799
      - name: parent-entity-type
        in: header
        schema:
          type: string
          enum:
          - PLATFORM
          - EMBEDDED_PLATFORM
        description: Code for the Parent Entity Type in the merchant hierarchy applicable to this request (e.g. platform in ISV use cases).
      requestBody:
        description: Create a new subscription
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/subscription'
            examples:
              Success:
                value:
                  recipientDetails:
                    firstName: John
                    lastName: Doe
                    emailAddress: john.doe@myemail.com
                    telephoneNumber: 800-980-9890
                    telephoneCountryCode: '+1'
                    preferredLanguage: en-US
                  notifications:
                    paymentUpdateNotification:
                    - All
                  callbackURL: https://merchant.notification.com
                  subscriptionChannel: WEBHOOK
                  subscriptionChannels:
                  - WEBHOOK
              Success Payout:
                value:
                  recipientDetails:
                    firstName: John
                    lastName: Doe
                    emailAddress: john.doe@myemail.com
                    telephoneNumber: 800-980-9890
                    telephoneCountryCode: '+1'
                  notifications:
                    payoutNotification:
                    - All
                  subscriptionChannel: EMAIL
                  subscriptionChannels:
                  - EMAIL
              Success Client Secret Post:
                value:
                  notifications:
                    paymentUpdateNotification:
                    - All
                  securityPreferences:
                    webhookAuthorizationType: token
                    tokenEndpointAuthorizationType: client_secret_post
                    mTLSEnabled: false
                    authorizationDetails:
                      clientCredentials:
                        clientId: 3e28334a-1b7d-490a-a35d-12345e80e87
                        clientSecret: n1onto1n1on
                        contentType: application/json
                        clientCredentialRequestBody:
                          grant_type: client_credentials
                          scope: CASHIER.GET_ACCESS
                      tokenEndpoint: AUTH_ENDPOINT
                  callbackURL: https://merchant.notification.com
                  subscriptionChannel: WEBHOOK
                  subscriptionChannels:
                  - WEBHOOK
              Success Private Key Jwt:
                value:
                  notifications:
                    paymentUpdateNotification:
                    - All
                  securityPreferences:
                    webhookAuthorizationType: token
                    tokenEndpointAuthorizationType: private_key_jwt
                    mTLSEnabled: false
                    authorizationDetails:
                      tokenEndpoint: AUTH_ENDPOINT
                      jwtDetails:
                        jwtHeaderFields:
                          typ: JWT
                          alg: RS256
                          kid: kid
                        jwtRequestBody:
                          sub: dsd5yhuyuiyok5vQMZdZT3o
                          iss: //mns-aws.jpmchase.com
                          aud: jpmchase.com
                        jwtRequestParameters:
                          grant_type: urn:ietf:params:oauth:grant-type:jwt-bearer
                          assertion: CLIENT_ASSERTION_JWT
                    signingAlgorithm: RSA
                  callbackURL: https://merchant.notification.com
                  subscriptionChannel: WEBHOOK
                  subscriptionChannels:
                  - WEBHOOK
              Authentication failure:
                value:
                  notifications:
                    disputeNotification:
                    - All
                  subscriptionChannel: EMAIL
                  subscriptionChannels:
                  - EMAIL
              Authorization failure:
                value:
                  notifications:
                    disputeNotification:
                    - All
                  callbackURL: https://merchant.notification.com
                  subscriptionChannel: WEBHOOK
                  subscriptionChannels:
                  - WEBHOOK
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/subscriptionsResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/adfsError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '504':
          description: Gateway Timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
  /subscriptions/{subscription-id}:
    get:
      summary: Get a subscription by subscription Id
      operationId: v1GetSubscriptionBySubscriptionId
      tags:
      - Subscriptions
      description: Retrieves a specific subscription using the subscription Id
      parameters:
      - name: request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
        description: A unique identifier provided by the requestor for each request.
        examples:
          Success:
            value: 7611d1bf-325c-4795-a828-ac21f9bea5dc
          Authentication failure:
            value: 7611d1bf-325c-4795-a828-ac21f9bea7ab
          Authorization failure:
            value: 7611d1bf-325c-4795-a828-ac21f9bea8dc
          Subscription not found:
            value: 7611d1bf-325c-4795-a828-ac21f9bea6ab
          Subscription Identifier Invalid:
            value: 7611d1bf-325c-4795-a828-ac21f9bea3ab
      - name: merchant-id
        in: header
        deprecated: true
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifier for the merchant account.
        examples:
          Success:
            value: '9876543210'
          Authentication failure:
            value: '9876543211'
          Authorization failure:
            value: '9876543212'
          Subscription not found:
            value: '9876543213'
          Subscription Identifier Invalid:
            value: '9876543214'
      - name: subscription-id
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: A unique identifier provided by the requestor for each request.
        examples:
          Success:
            value: 7611d1bf-326d-4795-a828-ac21f9bea5dc
          Authentication failure:
            value: 7611d1bf-326d-4795-a828-ac21f9bea6dc
          Authorization failure:
            value: 7611d1bf-326d-4795-a828-ac21f9bea7dc
          Subscription not found:
            value: f56f4c9c-f5d5-44db-8fc7-bd8155406d76
          Subscription Identifier Invalid:
            value: f561d1bf-326d-4795-a828-ac21f9bea555
      - name: entity-id
        in: header
        required: true
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifier for the entity.
        examples:
          Success:
            value: '9876543210'
          Authentication failure:
            value: '9876543211'
          Authorization failure:
            value: '9876543212'
      - name: entity-type
        in: header
        required: true
        schema:
          type: string
          enum:
          - MERCHANT
          - PLATFORM
          - CLIENT
          - ACCOUNT
          - EMBEDDED_PLATFORM
          - CONSUMER
        description: Type of entity  identifier.
      - name: parent-entity-id
        in: header
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifies the Parent Entity in the merchant hierarchy applicable to this request (e.g. platform ID in ISV use cases).
        examples:
          Success:
            value: 0123456797
          Authentication failure:
            value: 0123456798
          Authorization failure:
            value: 0123456799
      - name: parent-entity-type
        in: header
        schema:
          type: string
          enum:
          - PLATFORM
          - EMBEDDED_PLATFORM
        description: Code for the Parent Entity Type in the merchant hierarchy applicable to this request (e.g. platform in ISV use cases).
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/subscriptionResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/adfsError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '504':
          description: Gateway Timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
    put:
      summary: Update a specific subscription
      operationId: v1UpdateSubscriptionBySubscriptionId
      tags:
      - Subscriptions
      description: Update a specific subscription. Keep in mind that excluded fields will be interpreted as `null`. To avoid inadvertently removing data, be sure to send the existing fields as-is in addition to the fields being updated.
      parameters:
      - name: request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
        description: A unique identifier provided by the requestor for each request.
        examples:
          Success:
            value: 7611d1bf-325c-4795-a828-ac21f9bea5dc
          Authentication failure:
            value: 7611d1bf-325c-4795-a828-ac21f9bea7ab
          Authorization failure:
            value: 7611d1bf-325c-4795-a828-ac21f9bea8dc
          Subscription not found:
            value: 7611d1bf-325c-4795-a828-ac21f9bea6ab
          Subscription Identifier Invalid:
            value: 7611d1bf-325c-4795-a828-ac21f9bea3ab
      - name: merchant-id
        in: header
        deprecated: true
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifier for the merchant account.
        examples:
          Success:
            value: '9876543210'
          Authentication failure:
            value: '9876543211'
          Authorization failure:
            value: '9876543212'
          Subscription not found:
            value: '9876543213'
          Subscription Identifier Invalid:
            value: '9876543214'
      - name: subscription-id
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: A unique identifier provided by the requestor for each request.
        examples:
          Success:
            value: 7611d1bf-326d-4795-a828-ac21f9bea5dc
          Authentication failure:
            value: 7611d1bf-326d-4795-a828-ac21f9bea7dc
          Authorization failure:
            value: 7611d1bf-326d-4795-a828-ac21f9bea9dc
          Subscription not found:
            value: f56f4c9c-f5d5-44db-8fc7-bd8155406d76
          Subscription Identifier Invalid:
            value: f561d1bf-326d-4795-a828-ac21f9bea555
      - name: entity-id
        in: header
        required: true
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifier for the entity.
        examples:
          Success:
            value: '9876543210'
          Authentication failure:
            value: '9876543211'
          Authorization failure:
            value: '9876543212'
      - name: entity-type
        in: header
        required: true
        schema:
          type: string
          enum:
          - MERCHANT
          - PLATFORM
          - CLIENT
          - ACCOUNT
          - EMBEDDED_PLATFORM
          - CONSUMER
        description: Type of entity  identifier.
      - name: parent-entity-id
        in: header
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifies the Parent Entity in the merchant hierarchy applicable to this request (e.g. platform ID in ISV use cases).
        examples:
          Success:
            value: 0123456797
          Authentication failure:
            value: 0123456798
          Authorization failure:
            value: 0123456799
      - name: parent-entity-type
        in: header
        schema:
          type: string
          enum:
          - PLATFORM
          - EMBEDDED_PLATFORM
        description: Code for the Parent Entity Type in the merchant hierarchy applicable to this request (e.g. platform in ISV use cases).
      requestBody:
        description: Update an existing notification subscription
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/subscription'
            examples:
              Success:
                value:
                  recipientDetails:
                    firstName: John
                    lastName: Doe
                    emailAddress: john.doe@myemail.com
                    telephoneNumber: 800-980-9890
                    telephoneCountryCode: '+1'
                    preferredLanguage: en-US
                  notifications:
                    paymentUpdateNotification:
                    - All
                  callbackURL: https://merchant.notification.com
                  subscriptionChannel: WEBHOOK
                  subscriptionChannels:
                  - WEBHOOK
              Authentication failure:
                value:
                  notifications:
                    disputeNotification:
                    - All
                  callbackURL: https://merchant.notification.com
                  subscriptionChannel: EMAIL
                  subscriptionChannels:
                  - EMAIL
              Authorization failure:
                value:
                  notifications:
                    disputeNotification:
                    - All
                  callbackURL: https://merchant.notification.com
                  subscriptionChannel: WEBHOOK
                  subscriptionChannels:
                  - WEBHOOK
              Subscription not found:
                value:
                  notifications:
                    disputeNotification:
                    - All
                  callbackURL: https://merchant.notification.com
                  subscriptionChannel: EMAIL
                  subscriptionChannels:
                  - EMAIL
              Subscription Identifier Invalid:
                value:
                  notifications:
                    disputeNotification:
                    - All
                  callbackURL: https://merchant.notification.com
                  subscriptionChannel: WEBHOOK
                  subscriptionChannels:
                  - WEBHOOK
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/subscriptionsResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/adfsError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '504':
          description: Gateway Timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
    delete:
      summary: Delete a specific subscription
      operationId: v1DeleteSubscriptionBySubscriptionId
      tags:
      - Subscriptions
      description: Delete a specific subscription
      parameters:
      - name: merchant-id
        in: header
        deprecated: true
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifier for the merchant account.
        examples:
          Success:
            value: '9876543210'
          Authentication failure:
            value: '9876543211'
          Authorization failure:
            value: '9876543212'
          Subscription not found:
            value: '9876543213'
          Subscription Identifier Invalid:
            value: '9876543214'
      - name: request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
        description: A unique identifier provided by the requestor for each request.
        examples:
          Success:
            value: 7611d1bf-325c-4795-a828-ac21f9bea5dc
          Authentication failure:
            value: 7611d1bf-325c-4795-a828-ac21f9bea7ab
          Authorization failure:
            value: 7611d1bf-325c-4795-a828-ac21f9bea8dc
          Subscription not found:
            value: 7611d1bf-325c-4795-a828-ac21f9bea6ab
          Subscription Identifier Invalid:
            value: 7611d1bf-325c-4795-a828-ac21f9bea3ab
      - name: subscription-id
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: A unique identifier provided by the requestor for each request.
        examples:
          Success:
            value: 44444444-4017-11e9-b649-8de064221544
          Authentication failure:
            value: 55544444-4017-11e9-b649-8de064221544
          Authorization failure:
            value: 66644444-4017-11e9-b649-8de064221544
          Subscription not found:
            value: f56f4c9c-f5d5-44db-8fc7-bd8155406d76
          Subscription Identifier Invalid:
            value: f561d1bf-326d-4795-a828-ac21f9bea555
      - name: entity-id
        in: header
        required: true
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifier for the entity.
        examples:
          Success:
            value: '9876543210'
          Authentication failure:
            value: '9876543211'
          Authorization failure:
            value: '9876543212'
          Subscription not found:
            value: '9876543213'
          Subscription Identifier Invalid:
            value: '9876543214'
      - name: entity-type
        in: header
        required: true
        schema:
          type: string
          enum:
          - MERCHANT
          - PLATFORM
          - CLIENT
          - ACCOUNT
          - EMBEDDED_PLATFORM
          - CONSUMER
        description: Type of entity  identifier.
      - name: parent-entity-id
        in: header
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifies the Parent Entity in the merchant hierarchy applicable to this request (e.g. platform ID in ISV use cases).
        examples:
          Success:
            value: 0123456797
          Authentication failure:
            value: 0123456798
          Authorization failure:
            value: 0123456799
      - name: parent-entity-type
        in: header
        schema:
          type: string
          enum:
          - PLATFORM
          - EMBEDDED_PLATFORM
        description: Code for the Parent Entity Type in the merchant hierarchy applicable to this request (e.g. platform in ISV use cases).
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/adfsError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
        '504':
          description: Gateway Timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messages'
  /publicKeys:
    get:
      summary: (***DEPRECATED***) Get a public key by entity Id
      operationId: v1PublicKeyGet
      tags:
      - Subscriptions
      description: (***DEPRECATED***)  Retrieve a public key using the Entity Id.
      deprecated: true
      parameters:
      - name: request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
        description: A unique identifier provided by the requestor for each request.
        examples:
          Success:
            value: 7611d1bf-325c-4795-a828-ac21f9bea5dc
      - name: merchant-id
        in: header
        deprecated: true
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifier for the merchant account.
        examples:
          Success:
            value: '9876543210'
      - name: entity-id
        in: header
        required: true
        schema:
          type: string
          pattern: ^[0-9]{8,12}$
        description: Identifier for the entity.
        examples:
          Success:
            value: '9876543210'
      - name: entity-type
        in: header
        required: true
        schema:
          type: string
          enum:
          - MERCHANT
          - PLATFORM
          - CLIENT
          - ACCOUNT
          - EMBEDDED_PLATFORM
          - CONSUMER
        description: Type of entity  identifier.
      - name: signingAlgorithm
        in: quer

# --- truncated at 32 KB (83 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/jp-morgan-chase/refs/heads/main/openapi/jp-morgan-chase-subscriptions-api-openapi.yml