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.
SocialMediaList
array
The entity's social media profiles.
BirthDate
string
The date of birth (yyyy-MM-dd) of the individual in case of party type being an individual.
OrganizationDetailsRequired
2 required
IndividualDetailsRequired
2 required
NameSuffix
string
The name suffix used by the party
AmexOptBlueServiceEstablishmentNumber
string
Unique identifier assigned to a merchant/business that participates in the American Express OptBlue program
JcbAccepted
boolean
Indicates if the merchant will accept JCB cards. Required American Express OptBlue is selected in Australia, New Zealand, or Canada.
UpdatePartyRequest
object
9 properties
ExternalId
string
ID in external system.
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\(\)\/\&\+\%\@\\;\,\.\:\ \-\']$.
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…
NetworkRegistrationCurrencyCode
string
The merchant's preferred currency for transactions. Required when AMEXOPTBLUE is selected.
PartyType
string
The party type
VisaDebitAcceptance
string
The type of Visa debit card acceptance. Required when VISA is selected.
IndividualJobTitleDescription
string
If jobTitle is Other, then job title description is required.
Name
string
The name of the party. A party can be an individual or an organization.
OrganizationIdentityDto
object
The tax ID of the organization.
5 properties
3 required
ValidationType
string
The type of validation process. | Type | Description | | -- | -- | | ENTITYVALIDATION | Validation of the party identity. | | LIVENESSCHECK | Validation of the…
ApiErrorContext
object
Context of the API error.
4 properties
1 required
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…
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…
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
MerchantCategoryCode
string
The merchant category code describing the merchant's industry.
OrganizationDetails
object
Details of an organization.
22 properties
PageMetaData
object
Page metadata.
3 properties
IndividualDetails
object
Details of an individual.
15 properties
ValidationResponse
array
List of validation info.
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…
PartySummaryResponse
object
Summary of party data in collection lookup.
11 properties
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…
PartyResponse
object
17 properties
AmexSellerId
string
The ID that identifies the merchant account when processing with American Express OptBlue.
YearOfFormation
string
Year of company formation.
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…
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) -…
ParentPartyId
string
The parent party ID.
OrganizationIndustry
object
2 properties
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…
Active
boolean
Whether the party is active or not. False if inactive.
PhoneSmbdo
object
Phone number information of the party.
3 properties
2 required
SocialMedia
object
2 properties
2 required
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 '^…
CreatePartyRequest
object
11 properties
2 required
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…
AccessList
array
List of user access descriptors.
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…
ListPartyResponse
object
A page of party summaries
2 properties
WebsiteAvailable
boolean
Whether the party has a website. False if opted out.
DiscoverMerchantId
string
The ID that identifies the merchant account when processing with Discover.
AddressDto
object
An address.
6 properties
4 required
NetworkRegistration
object
Network registration configuration.
13 properties
DiscoverDebtRepayment
boolean
Indicates if the merchant will be accepting Discover cards as a part of Discover's consumer debt repayment program.
SocialMediaUrl
string
Social media profile URL.
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) +…
TransactionDeviceType
string
The mechanism used to provide details at the merchant's terminal for transactions. Required when DISCOVER is selected.
ValidationStatus
string
Status of a party validation. Missing fields result in NEEDSINFO.
CountryCodeIsoAlpha2
string
Country code in ISO alpha-2 format.
SettlementPaymentMethods
string
The method of payment used in network registration.
Website
string
Name/URL of the website
schemas-ApiError
object
An API error.
5 properties
2 required
EntitiesInOwnership
boolean
Entities in ownership means that one or more businesses own part of the business connected to the client.
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…
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…
PartyField
object
A party field. It refers to either a missing field or a field that needs to be updated.
3 properties
OrganizationDescription
string
The organization's description.
NatureOfOwnership
string
Nature of ownership. Allowed values are: Direct, Indirect.
PartyId
string
Organization/Individual party id, that uniquely identifies the party.
IndividualIdentity
object
An individual's identification. For MerchantServices product in Canada, individual party ID is optional.
5 properties
3 required
The full machine-readable OpenAPI contract behind this narrative.
Other APIs JPMorgan Chase publishes across the network.
