How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

JPMorgan Chase Account Updates API

Request updates to an account.

JPMorgan Chase Account Updates API is one of 65 APIs that JPMorgan Chase publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Account Updates. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 2 operations across 2 paths, and defines 27 schemas. It is described by OpenAPI 3.2.0, at version 1.4.0.

Requests are made against 3 base URLs: https://api-ms.payments.jpmorgan.com/api/v1, https://api-ms-test.payments.jpmorgan.com/api/v1, https://api-mock.payments.jpmorgan.com/api/v1.

2 operations 2 paths 27 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.4.0
Base URL
https://api.payments.jpmorgan.com/onboarding/v1
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

JPMorgan Chase Account Updates API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). By default, every request must be authenticated.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Account Updates 2

Request updates to an account.

POST
/account-updates
Query Account Updater service.
2 params body → 201400401403429500503504
GET
/account-updates/{account-identifier}
Get information about an account update.
3 params → 200400401403404500503504

Schemas 27

The contract defines 27 schemas that model the data the API accepts and returns. The most detailed are accountGetUpdateResponse (11 properties), accountUpdateResponse (10 properties), resultsMessage (8 properties), accountUpdaterResult (6 properties). Each schema is shown below with its type and property counts.

accountInformation
object
Object that contains card account details, including card number, expiration date, and account number type.
3 properties
merchantRecordIdentifier
string
Merchant-supplied record identifier preferably in UUID format. Used to correlate API requests with internal records.
validationMessage
object
Object containing information about transaction validation.
3 properties
accountUpdaterResult
object
Object that contains the result of the account update process, including old and new account information,payment network response, and outcome messages.
6 properties
expiry
object
Object that contains the card expiration date, including month and year.
2 properties 2 required
requestId
string
Unique identifier of the API request designated by the merchant. Must be a valid UUID.
requestStatus
string
Registration state of the card for the submitted request (REGISTERED, UNREGISTERED, etc.). Reflects current enrollment status.
messages
object
A list of errors and warnings.
4 properties 2 required
responseId
string
Unique response identifier (UUID). Used to track and reference API responses.
resultsMessage
object
Object that contains the result details of the account update process, including old and new account information, network response codes, and outcome messages.
8 properties
newAccountInformation
object
Object that contains updated card account information when available, including card number, expiration date, account number type, and payment method change st…
5 properties
networkResponse
object
Object that contains account update response information from the payment network, including response codes and messages.
2 properties
responseCode
string
The response code representing the outcome of the request. Allowed values are defined by the application.
cardTypeName
string
Payment method label used to identify the card brand or payment network, for example, Visa, Mastercard, Discover.
accountUpdateRequest
object
Request updated information for an account. Information is delivered via the notification interface.
5 properties
code
string
The error code returned when an exception is encountered by the system or a connected component. Allowed values are defined by the application.
year
integer
Card expiration year (four-digit integer, for example, 2026). Indicates when the card expires.
responseStatus
string
The result status of the request. Allowed values are "SUCCESS" and "ERROR".
message
string
The detailed message describing the error encountered.
responseMessage
string
Detailed explanation of the account update response. Provides context for the outcome of the request.
cardAccountAction
string
Action to register or unregister the account number for automated updates (requires notification service enrollment).
accountUpdateResponse
object
Information on update request. Pending indicates that request is being processed. Delivered indicates that a response has been sent to the callback URL provide…
10 properties 4 required
accountNumberType
string
Type of payment method for the account number, for example, PAN, SAFETECHTOKEN. Determines processing method.
accountGetUpdateResponse
object
Information about an account.
11 properties 4 required
subMerchantId
string
Sub-merchant entity identifier (up to 12 numeric digits). Used for transaction processing and reporting at the lowest account hierarchy.
oldAccountInformation
object
Object that contains the card account information submitted in the request, including card number, expiration date, and account number type.
4 properties
month
integer
Card expiration month (integer 1-12). Indicates when the card expires.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

jp-morgan-chase-account-updates-api-openapi.yml Raw ↑

Other APIs JPMorgan Chase publishes across the network.

Notifications API
Accounts API
Recipients API
Webhooks API
Transactions API
Documents API
JPMorgan Chase Account Information API
JPMorgan Chase Account Restrictions API
JPMorgan Chase Account Services API
JPMorgan Chase Account Statements API
JPMorgan Chase Account Transactions API
JPMorgan Chase Account Validation API
Where this information came from

This is an independent, third-party profile of JPMorgan Chase Account Updates API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.