JPMorgan Chase Party 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 Party. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes
6 operations
across 3 paths,
and defines 71 schemas.
It is described by OpenAPI 3.2.0, at version 1.0.18.
Requests are made against 3 base URLs: https://api.payments.jpmorgan.com/onboarding/v1, https://api-sandbox.payments.jpmorgan.com/onboarding/v1, https://api-mock.payments.jpmorgan.com/onboarding/v1.
The identity and technical contract details declared by the specification.
NetworkRegistration
object
Network registration configuration.
13 properties
FirstName
string
First name of the individual in case of party type being an individual like Owners, Controllers and Decision Makers. The format is enforced with the pattern '^…
MiddleName
string
Middle name of the individual in case of party type being an individual. The format is enforced with the pattern ^[a-zA-Z0-9\(\)\/\&\+\%\@\\;\,\.\:\ \-\']$.
TransactionDeviceType
string
The mechanism used to provide details at the merchant's terminal for transactions. Required when DISCOVER is selected.
ExternalId
string
ID in external system.
PartyType
string
The party type
DefaultLanguagePreferenceEnum
string
The default language preference of the party's user. It defines the initial language of user communications during client onboarding. Any changes to the user's…
OrganizationIdentityDto
object
The tax ID of the organization.
5 properties
3 required
ListPartyResponse
object
A page of party summaries
2 properties
OrganizationName
string
The organization's legal name. It is the official name of the person or entity that owns a company. Must be the name used on the legal party's government forms…
PartyResponse
object
17 properties
IndividualDetailsRequired
2 required
PartyId
string
Organization/Individual party id, that uniquely identifies the party.
UpdatePartyRequest
object
9 properties
OrganizationDetails
object
Details of an organization.
22 properties
OrganizationType
string
This field specifies the legal structure or classification of the organization and identifies whether the entity is a Corporation, Sole Proprietorship, Non-Pro…
IndividualIdentity
object
An individual's identification. For MerchantServices product in Canada, individual party ID is optional.
5 properties
3 required
SettlementPaymentMethods
string
The method of payment used in network registration.
OrganizationIndustry
object
2 properties
AddressDto
object
An address.
6 properties
4 required
DbaName
string
An alternate name that the business is doing business under. Provide this if your business is registered with an alias. The format is enforced with the pattern…
NatureOfOwnership
string
Nature of ownership. Allowed values are: Direct, Indirect.
PageMetaData
object
Page metadata.
3 properties
ValidationType
string
The type of validation process. | Type | Description | | -- | -- | | ENTITYVALIDATION | Validation of the party identity. | | LIVENESSCHECK | Validation of the…
CountryCodeIsoAlpha2
string
Country code in ISO alpha-2 format.
PartyField
object
A party field. It refers to either a missing field or a field that needs to be updated.
3 properties
OrganizationDetailsRequired
2 required
JcbAccepted
boolean
Indicates if the merchant will accept JCB cards. Required American Express OptBlue is selected in Australia, New Zealand, or Canada.
DiscoverDebtRepayment
boolean
Indicates if the merchant will be accepting Discover cards as a part of Discover's consumer debt repayment program.
PartyRoleList
array
A list of party roles. - CLIENT: A party that is the business entity. Only one party under a client may have this role. No other role can be specified alongsid…
EntitiesInOwnership
boolean
Entities in ownership means that one or more businesses own part of the business connected to the client.
Email
string
Email of the party. The email is validated against the [RFC 2822](https://datatracker.ietf.org/doc/html/rfc2822) format, which is 64 characters (local part) +…
PartySummaryResponse
object
Summary of party data in collection lookup.
11 properties
AmexOptBlueMarketing
boolean
Indicates whether the merchant has opted-in to American Express OptBlue marketing. - true – All Marketing (Merchant has not opted out of receiving marketing) -…
ApiErrorContext
object
Context of the API error.
4 properties
1 required
BirthDate
string
The date of birth (yyyy-MM-dd) of the individual in case of party type being an individual.
IndividualJobTitleDescription
string
If jobTitle is Other, then job title description is required.
AccessList
array
List of user access descriptors.
OrganizationIndustryType
string
The industry type of the business connected to the client. You can use the [Industry Descriptor Reference](https://developer.payments.jpmorgan.com/docs/embedde…
ValidationStatus
string
Status of a party validation. Missing fields result in NEEDSINFO.
PubliclyTraded
object
Provide details for stock exchange and ticker symbol if your organization is a publicly traded company. If your organization is a subsidiary use these fields t…
3 properties
2 required
schemas-ApiError
object
An API error.
5 properties
2 required
Website
string
Name/URL of the website
IndividualJobTitle
string
Job title in the case of party type being an INDIVIDUAL. Job title is a required field for controllers, beneficial owners, and decision makers. Allowed values…
DiscoverMerchantId
string
The ID that identifies the merchant account when processing with Discover.
AmexOptBlueServiceEstablishmentNumber
string
Unique identifier assigned to a merchant/business that participates in the American Express OptBlue program
OrganizationDescription
string
The organization's description.
MerchantCategoryCode
string
The merchant category code describing the merchant's industry.
SocialMediaUrl
string
Social media profile URL.
ValidationResponse
array
List of validation info.
OrganizationIndustryCategory
string
The industry category of the business connected to the client. For example, Accommodation and Food Services. You can use the [Industry Descriptor Reference](ht…
WebsiteAvailable
boolean
Whether the party has a website. False if opted out.
LastName
string
Last name of the individual in case of party type being an individual like Owners, Controllers and Decision Makers. The format is enforced with the pattern ^[a…
SocialMediaList
array
The entity's social media profiles.
NetworkRegistrationCurrencyCode
string
The merchant's preferred currency for transactions. Required when AMEXOPTBLUE is selected.
ParentPartyId
string
The parent party ID.
SocialMedia
object
2 properties
2 required
PhoneSmbdo
object
Phone number information of the party.
3 properties
2 required
Name
string
The name of the party. A party can be an individual or an organization.
Role
string
The party's role. - CLIENT: A party that is the business entity. Only one party under a client may have this role. No other role can be specified alongside CLI…
NameSuffix
string
The name suffix used by the party
Active
boolean
Whether the party is active or not. False if inactive.
IndividualDetails
object
Details of an individual.
15 properties
YearOfFormation
string
Year of company formation.
CreatePartyRequest
object
11 properties
2 required
ServiceEstablishmentStatus
string
The American Express status code for the merchant if they are terminated or reinstated. The payment provider must provide this if the merchant was previously t…
AmexSellerId
string
The ID that identifies the merchant account when processing with American Express OptBlue.
VisaDebitAcceptance
string
The type of Visa debit card acceptance. Required when VISA is selected.
The full machine-readable OpenAPI contract behind this narrative.
Other APIs JPMorgan Chase publishes across the network.
