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

Account Updater API

The Account Updater API provides recurring and stored payment merchants with their customers latest card account credentials.

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

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

This API exposes 3 operations across 3 paths, organized into 2 resource areas, and defines 30 schemas. It is described by OpenAPI 3.0.1, 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.

3 operations 3 paths 30 schemas 2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.4.0
Base URL
https://api-ms.payments.jpmorgan.com/api/v1
Authentication
HTTP Bearer
Resource Areas
2

Authentication & Security 1

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

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 2 GET, 1 POST. They span 2 resource areas: Health Check, Account Updates. Each is listed below with its method, path, parameters, and response codes.

Health Check 1

Validate the health of the service.

GET
/healthcheck
Health check for the Account Updater service.
→ 200500503504
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 30

The contract defines 30 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.

accountGetUpdateResponse
object
Information about an account.
11 properties 4 required
oldAccountInformation
object
Object that contains the card account information submitted in the request, including card number, expiration date, and account number type.
4 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
expiry
object
Object that contains the card expiration date, including month and year.
2 properties 2 required
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
accountUpdateRequest
object
Request updated information for an account. Information is delivered via the notification interface.
5 properties
subMerchantId
string
Sub-merchant entity identifier (up to 12 numeric digits). Used for transaction processing and reporting at the lowest account hierarchy.
cardAccountAction
string
Action to register or unregister the account number for automated updates (requires notification service enrollment).
responseId
string
Unique response identifier (UUID). Used to track and reference API responses.
requestStatus
string
Registration state of the card for the submitted request (REGISTERED, UNREGISTERED, etc.). Reflects current enrollment status.
month
integer
Card expiration month (integer 1-12). Indicates when the card expires.
year
integer
Card expiration year (four-digit integer, for example, 2026). Indicates when the card expires.
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
adfsError
object
Object containing information about the active directory file system error.
3 properties 3 required
responseCode
string
The response code representing the outcome of the request. Allowed values are defined by the application.
messages
object
A list of errors and warnings.
4 properties 2 required
responseStatus
string
The result status of the request. Allowed values are "SUCCESS" and "ERROR".
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.
message
string
The detailed message describing the error encountered.
validationMessage
object
Object containing information about transaction validation.
3 properties
merchantRecordIdentifier
string
Merchant-supplied record identifier preferably in UUID format. Used to correlate API requests with internal records.
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
healthCheckResource
object
Contains health check information about a resource.
1 property 1 required
status
string
Current health status of the resource (for example, UP, DOWN). Used to monitor service availability.
requestId
string
Unique identifier of the API request designated by the merchant. Must be a valid UUID.
responseMessage
string
Detailed explanation of the account update response. Provides context for the outcome of the request.
accountInformation
object
Object that contains card account details, including card number, expiration date, and account number type.
3 properties
networkResponse
object
Object that contains account update response information from the payment network, including response codes and messages.
2 properties
cardTypeName
string
Payment method label used to identify the card brand or payment network, for example, Visa, Mastercard, Discover.
accountNumberType
string
Type of payment method for the account number, for example, PAN, SAFETECHTOKEN. Determines processing method.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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

Other APIs JPMorgan Chase publishes across the network.

Digital Onboarding API
Consumer Profile Management API
Tokenization API
Reporting API
Notifications API
Request to Pay via QR Code API
Checkout API
Dispute Management API
Accounts API
Alerts and Decisioning API
Product Configuration API
Recipients API
Where this information came from

This is an independent, third-party profile of Account Updater 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.