Party

Party APIs help you to interact with party micro services. The Party micro service is used to store various details about the party, such as personal information, identity details, and address details. By using the Party APIs, you can create, update, or get the parties in the party micro service.

Name Description Introduced In
getReferenceData This API fetches party enrichment data from the Party micro services for the application. 2020.04
createProspectProfile This API creates a party. 2020.04
resumeOnboardingApplication This API resumes the Onboarding application. 2020.04
updateProspectProfile This API updates the prospect and party details in addition to Journey Manager. 2020.04
CreateCoApplicant This API creates co-applicant party details. 2020.04
createParty This API creates a new Party in the Party Microservice 2020.07
getParty This API fetches the Party information from the Party Microservice. 2020.07
updateParty This API updates the Party in the Party Microservice. 2020.07
ClosedgetReferenceData
 
Description: This API fetches party enrichment data from the Party micro services for the application.
Method: GET
URL: {baseUrl}/services/data/v1/PartyObjectService/operations/Reference/getReferenceData
Security Level: Anonymous App Users
Header Request:
  • X-Kony-Authorization
Body Request:

Parameters

referenceId

Specifies the type of enrichment that must be fetched from the Party microservice.

{
	“referenceId” : “Country”
}
Response:

Countrys [ ]

Contains data that related to a country.

Parameters

Countrys/iddPrefix

Specifies the IDD.PREFIX for the country.

Countrys/countryCode

Specifies the country code.

Countrys/numericCountryCode

Specifies the numeric country code.

Countrys/countryName

Specifies the country name.

Countrys/highRiskCountry

Specifies the high-risk value for the country.

{
  "countrys": [
    {
      "iddPrefix": 1,
      "countryCode": "US",
      "numericCountryCode": 1,
      "alpha3CountryCode": "USA",
      "countryName": "United States",
      "highRiskCountry": true
    },
    {
      "iddPrefix": 91,
      "countryCode": "IN",
      "numericCountryCode": 17,
      "alpha3CountryCode": "IND",
      "countryName": "India",
      "highRiskCountry": false
    }
  ]
}
Error Code(s): Error code : 8009
Error message : Backend request failed
Associated Enterprise APIs: {partyHost}/reference/$referenceId
ClosedcreateProspectProfile
 
Description: This API creates a party.
Method: POST
URL: {baseURL}/services/data/v1/OnBoarding/operations/Application/createProspectProfile
Security Level: Anonymous App Users
Header Request:

X-Kony-Authorization

Body Request:

Parameters

FirstName

Specifies the first name of the applicant.

LastName

Specifies the last name of the applicant.

DateOfBirth

Specifies the date of birth of the applicant.

Email

Specifies the email address of the applicant.

MobileCountryCode

Specifies the mobile country code of the applicant.

MobileNumber

Specifies the mobile number of the applicant.

ApplicantType

Specifies the type of applicant such as general applicant or co-applicant.

Application_id

Specifies the Journey Manager tracking ID.

{ 
  "FirstName": "Nathan", 
  "LastName": "Drake", 
  "DateOfBirth": "1990-10-10", 
  "Email": "nathan_drake@uncharted.com", 
  "MobileCountryCode": "+1", 
  "MobileNumber": "9517536545",  
  "Application_id": "ZMZY8MG", 
  "ApplicantType": "Applicant",
}
Response:

Parameters

/Party_id

Specifies the ID that is created for the prospect in Party micro service.

/id

Specifies the Journey Manager tracking code of the application.

{
    "opstatus":0,"Party_id":"2009854036",
    "id":"N34DMCD",
    "httpStatusCode":200
}
Error Code(s):
  • Error code : 75300
    Error message : Create DBX prospect failed.
  • Error code : 75303
    Error message : Create customer application failed.
  • Error code : 75104
    Error message : Update JM application failed .
  • Error code : 75302
    Error message : Customer application update failed.
  • Error code : 75602
    Error message : Create prospect profile failed.
Associated Enterprise APIs: None
ClosedresumeOnboardingApplication
 
Description: This API resumes the onboarding application.
Method: POST
URL: {baseUrl}/services/data/v1/OnBoarding/operations/Application/resumeOnBoardingApplication
Security Level: Anonymous App User
Header Request:
  • X-Kony-Authorization
  • X-Kony-ReportingParams
Body Request:

Parameters

id

Specifies the Journey Manager tracking code.

challengeAnswer

Specifies the challenge answer required to resume the application.

PhoneNumber

Specifies the phone number used while creating the application

{
 "id":"N34DMCD",
"challengeAnswer":"1990-10-10",
 "PhoneNumber":"+19517536545"
}
Response:

ApplicationResponse { }

Contains the entire response

Parameters

ApplicationResponse /Status

Specifies the status of the application.

ApplicationResponse /StartDate

Specifies the start date of the application.

ApplicationResponse /ApplicationType

Specifies the type of application.

ApplicationResponse /EligibilityCritirea

Specifies the eligibility criteria selected by the applicant.

ApplicationResponse /IsExistingCustomer

Specifies if the applicant is an existing customer.

ApplicationResponse /TnCFlag

Specifies if the applicant has accepted terms and conditions.

ApplicationResponse /CoApplicationCount

Specifies the number of co applicants in the application.

ApplicationResponse /ProductSelection

Specifies the list of product names, IDs and currencies selected by the applicant.

ApplicationResponse /IsConsentAccepted

Specifies if the user has consented for the data.

ApplicationResponse /PhoneNumber

Specifies the phone number of the applicant.

ApplicationResponse/SectionStatusCoApplicant

Specifies the section wise statuses of the co applicant.

ApplicationResponse/SectionStatus/ProductSelection

Specifies the status of the product selection of the applicant.

ApplicationResponse/SectionStatus/Applicant

Specifies the section wise statuses of the applicant.

ApplicationResponse/Party_ids/CoApplicant

Specifies the Party ID of the co applicant.

ApplicationResponse/Party_ids/Applicant

Specifies the party ID of the applicant.

{ 
ApplicationResponse":
    {
        "Status":"InProgress",
        "StartDate":"2020-04-07",
        "ApplicationType":"",
        "EligibilityCriteria":"",
        "IsExistingCustomer":"",
        "TnCFlag":"",
        "CoApplicantCount":"",
        "ProductSelection":[
        {
            "ProductCurrency1":"",
            "ProductCurrency2":"",
            "ProductCurrency3":"",
            "ProductID4":"",
            "ProductCurrency4":"",
            "ProductID5":"",
            "ProductCurrency5":"",
            "ProductID2":"",
            "ProductID3":"",
            "ProductID1":"",
            "ProgressStatus":"",
            "ProductName2":"",
            "ProductName3":"",
            "ProductName4":"",
            "ProductName5":"",
            "ProductName1":""
        }
],"IsConsentAccepted":""
    }
,"PhoneNumber":"+19517536545",
    "opstatus":0,"SectionStatus":
    {
        "CoApplicant":
        {
            "PersonalInfo":"",
            "IDVInfo":"",
            "IdentityInfo":"",
            "AddressInfo":""
        }
,"ProductSelection":
        {
            "ProgressStatus":""
        }
,"Applicant":
        {
            "PersonalInfo":"Done",
            "IDVInfo":"",
            "IdentityInfo":"",
            "AddressInfo":""
        }
    }
,"Party_ids":
    {
        "CoApplicant":"",
        "Applicant":"2009854036"
    }
,"httpStatusCode":200
}
Error Code(s):
  • Error code : 77214
    Error message : Failed to resume application
  • Error code : 77215
    Error message : Phone number, save challenge answer and application do not match
Associated Enterprise APIs: None
ClosedupdateProspectProfile
 
Description: This API updates the prospect and party details in addition to Journey Manager.
Method: POST
URL: {baseUrl}/services/data/v1/OnBoarding/operations/PersonalInfo/updateProspectProfile
Security Level: Anonymous app users
Header Request:

X-Kony-Authorization

Body Request:

Parameters

FirstName

Specifies the first name of the applicant.

LastName

Specifies the last name of the applicant.

DateOfBirth

Specifies the date of birth of the applicant.

Email

Specifies the email address of the applicant.

MobileCountryCode

Specifies the mobile country code of the applicant.

MobileNumber

Specifies the mobile number of the applicant.

ApplicantType

Specifies the type of applicant such as general applicant or co-applicant.

Application_id

Specifies the Journey Manager tracking ID.

{ 
  "FirstName": "Nathan", 
  "LastName": "Drake", 
  "DateOfBirth": "1990-10-10", 
  "Email": "nathan_drake@uncharted.com", 
  "MobileCountryCode": "+1", 
  "MobileNumber": "9517536545",  
  "Application_id": "N34DMCD", 
  "ApplicantType": "Applicant",
}
Response: 
{
"opstatus":0,
"httpStatusCode":200
}
Error Code(s):
  • Error code : 71000
    Error message : Error occurred while updating prospect profile.
  • Error code : 75309
    Error message : failed to update prospect details.
  • Error code : 75302
    Error message : Customer application update failed.
  • Error code : 75104
    Error message : Update JM application failed.
Associated Enterprise APIs: None
ClosedCreateCoApplicant
 
Description: This API creates co-applicant party details.
Method: POST
URL: {baseUrl}/services/data/v1/OnBoarding/operations/Application/createCoApplicant
Security Level: Anonymous App Users.
Header Request:
  • X-Kony-Authorization
Body Request:

Parameters

FirstName

Specifies the first name of the co-applicant.

LastName

Specifies the last name of the co-applicant.

DateOfBirth

Specifies the date of birth of the co-applicant.

Email

Specifies the email address of the co-applicant.

MobileCountryCode

Specifies the mobile country code of the co-applicant.

MobileNumber

Specifies the mobile number of the user of co-applicant.

ApplicantType

Specifies the type of applicant such as general applicant or co-applicant.

Application_id

Specifies the Journey Manager tracking ID.

{
"FirstName": "Francis", 
  "LastName": "Drake", 
  "DateOfBirth": "1995-10-10", 
  "Email": "francis@uncharted.com", 
  "MobileCountryCode": "+1", 
  "MobileNumber": "9517536575",  
  "Application_id": "N34DMCD", 
  "ApplicantType": "CoApplicant",
}
Response:

Parameters

/CoAppParty_id

Specifies the Party ID of the co-applicant.

{
  "opstatus": 0,
  "CoAppParty_id": "2009862812",
  "httpStatusCode": 200
}
Error Code(s):
  • Error code : 75300
    Error message : Create DBX prospect failed.
  • Error code : 75104
    Error message : Update JM application failed.
Associated Enterprise APIs: None
ClosedcreateParty
 
Description: This API creates a new Party in the Party Microservice
Method: POST
URL: {baseUrl}/services/data/v1/PartyServices/operations/Party/createParty
Security Level: Authenticated App User
Header Request:
  • X-Kony-Authorization
Body Request:

Parameters

partyType

Specifies the type of the party. The party type can be either Individual or Business.

phoneAddress

Specifies a JSON array that consists of a phone number. Each JSON object consists of a property of the phone number.

partyStatus

Specifies whether the party is active or a prospect.

partyNames

Specifies a JSON array that consists of various names.

electronicAddress

Specifies a JSON array that consists of an Email ID and its attributes in each JSON object.

contactAddress

Specifies a JSON array that consists of the contact address and its attributes in each JSON object.

{
	"partyType":"Individual",
	"phoneAddress" : "[{\"phoneAddressType\":\"Home Number\",\"internationalPhoneNo\":\"8143589876\",\"iddPrefixPhone\":\"+1\",\"nationalPhoneNo\":\"8143589876\"}]",
	"partyStatus":"Prospect",
	"partyNames":"[{\"startDate\":\"14-04-2020\",\"firstName\":\"sriram\",\"lastName\":\"sadineni\",\"middleName\":\"asad\",\"suffix\":\"Mr\"}]",
	"electronicAddress":"[{\"electronicAddressType\":\"Email\",\"electronicAddress\":\"srirama.sadineni2@kony.com\",\"electronicCommunicationType\":\"Primary\"}]",
	"contactAddress":"[{\"physicalAddressType\":\"Office\",\"startDate\":\"2020-03-26\",\"reliabilityType\":\"Confirmed\",\"contactName\":\"Rolf\",\"endDate\":\"2020-03-26\",\"countryCode\":\"US\",\"flatNumber\":\"151 or 7/3\",\"floor\":\"2\",\"buildingNumber\":\"3\",\"buildingName\":\"c/o Copenagen Fintech Labs\",\"streetName\":\"Grand Avenue\",\"town\":\"San leandro community center\",\"countrySubdivision\":\"Oakland\",\"postalOrZipCode\":\"510-286-4444\",\"addressCountry\":\"\",\"validatedBy\":\"\",\"postBoxNumber\":\"A3700\",\"usePurpose\":\"Home Address\",\"regionCode\":\"\",\"district\":\"\",\"department\":\"\",\"subDepartment\":\"\",\"landmark\":\"\"}]"
}	}
Response:

Parameters

/createStatus

Specifies whether the creation of the party was successful or not.

/partyId

Specifies a unique identifier for the created party.

 

{
    "createStatus": "success",
    "partyId": "2014040704",
    "opstatus": 0,
    "httpStatusCode": 0
}
Error Code(s):

None
ClosedgetParty
 
Description: This API fetches the Party information from the Party Microservice.
Method: POST
URL: {baseUrl}/services/data/v1/PartyServices/operations/Party/getParty
Security Level: Authenticated App User
Header Request:
  • X-Kony-Authorization
Body Request:

Parameters

partyId (Mandatory)

Specifies the unique identifier of the Party.

{
	"partyId":"2014040704"
}}
Response:

Parameters

partyType

Specifies the type of the party. The party type can be either Individual or Business.

phoneAddress

Specifies a JSON array that consists of a phone number. Each JSON object consists of a property of the phone number.

partyId

Specifies the unique identifier of the party.

partyStatus

Specifies whether the party is active or a prospect.

partyNames

Specifies a JSON array that consists of various names.

electronicAddress

Specifies a JSON array that consists of an Email ID and its attributes in each JSON object.

contactAddress

Specifies a JSON array that consists of the contact address and its attributes in each JSON object.

{
    "partyType": "Individual",
    "partyStatus": "Prospect",
    "electronicAddress": "[{\"electronicAddressType\":\"Email\",\"electronicAddress\":\"srirama.sadineni@kony.com\",\"electronicCommunicationType\":\"Primary\",\"contactPointType\":\"Electronic Address\",\"partyId\":\"2014040704\",\"startDate\":\"2020-05-20\"},{\"electronicAddressType\":\"Email\",\"electronicAddress\":\"srirama.sadineni2@kony.com\",\"electronicCommunicationType\":\"Primary\",\"contactPointType\":\"Electronic Address\",\"partyId\":\"2014040704\",\"startDate\":\"2020-05-19\"}]",
    "partyId": "2014040704",
    "phoneAddress": "[{\"phoneAddressType\":\"Home Number\",\"iddPrefixPhone\":\"+1\",\"nationalPhoneNumber\":\"8143589877\",\"contactPointType\":\"Phone Address\",\"partyId\":\"2014040704\",\"startDate\":\"2020-05-19\"}]",
    "contactAddresss": "[{\"town\":\"San leandro community center\",\"contactName\":\"Rolf\",\"flatNumber\":\"21\",\"subDepartment\":\"\",\"countrySubdivision\":\"Oakland\",\"usePurpose\":\"Home Address\",\"buildingName\":\"c/o Copenagen Fintech Labs\",\"streetName\":\"Grand Avenue\",\"regionCode\":\"\",\"postalOrZipCode\":\"510-286-4444\",\"reliabilityType\":\"Confirmed\",\"countryCode\":\"US\",\"district\":\"\",\"buildingNumber\":\"3\",\"postBoxNumber\":\"A3700\",\"validatedBy\":\"\",\"physicalAddressType\":\"Office\",\"partyId\":\"2014040704\",\"floor\":\"2\",\"department\":\"\",\"landmark\":\"\",\"startDate\":\"2020-05-19\"}]",
    "partyNamess": "[{\"firstName\":\"sri\",\"lastName\":\"sad\",\"middleName\":\"empty\",\"partyId\":\"2014040704\",\"suffix\":\"Mr\",\"startDate\":\"2020-05-19\"}]",
    "extensionData": "{}",
    "opstatus": 0,
    "httpStatusCode": 0
}
Error Code(s):

None
ClosedupdateParty
 
Description: This API updates the Party in the Party Microservice.
Method: POST
URL: {baseUrl}/services/data/v1/PartyServices/operations/Party/updateParty
Security Level: Authenticated App User
Header Request:
  • X-Kony-Authorization
Body Request:

Parameters

partyId (Mandatory)

Specifies the unique identifier of the Party.

partyType

Specifies the type of the party. The party type can be either Individual or Business.

phoneAddress

Specifies a JSON array that consists of a phone number. Each JSON object consists of a property of the phone number.

partyStatus

Specifies whether the party is active or a prospect.

partyNames

Specifies a JSON array that consists of various names.

electronicAddress

Specifies a JSON array that consists of an Email ID and its attributes in each JSON object.

contactAddress

Specifies a JSON array that consists of the contact address and its attributes in each JSON object.

{
	"partyId":"2014040704",
	"partyType":"Individual",
	"phoneAddress" : "[{\"phoneAddressType\":\"Home Number\",\"iddPrefixPhone\":\"+1\",\"nationalPhoneNumber\":\"8143589877\",\"startDate\":\"2020-05-19\"}]",
	"partyStatus":"Prospect",
	"partyNames":"[{\"startDate\":\"2020-05-19\",\"firstName\":\"sri\",\"lastName\":\"sad\",\"middleName\":\"empty\",\"suffix\":\"Mr\"}]",
	"electronicAddress":"[{\"electronicAddressType\":\"Email\",\"electronicAddress\":\"srirama.sadineni@kony.com\",\"electronicCommunicationType\":\"Primary\",\"startDate\":\"2020-05-19\"}]",
	"contactAddress":"[{\"startDate\":\"2020-05-19\",\"physicalAddressType\":\"Office\",\"reliabilityType\":\"Confirmed\",\"contactName\":\"Rolf\",\"endDate\":\"2020-03-26\",\"countryCode\":\"US\",\"flatNumber\":\"21\",\"floor\":\"2\",\"buildingNumber\":\"3\",\"buildingName\":\"c/o Copenagen Fintech Labs\",\"streetName\":\"Grand Avenue\",\"town\":\"San leandro community center\",\"countrySubdivision\":\"Oakland\",\"postalOrZipCode\":\"510-286-4444\",\"addressCountry\":\"\",\"validatedBy\":\"\",\"postBoxNumber\":\"A3700\",\"usePurpose\":\"Home Address\",\"regionCode\":\"\",\"district\":\"\",\"department\":\"\",\"subDepartment\":\"\",\"landmark\":\"\"}]"
}
Response:

Parameters

/updateStatus

Specifies whether the updation of the party was successful.

{
    "updateStatus": "success",
    "opstatus": 0,
    "httpStatusCode": 0
}
Error Code(s):

None

Bookmark Name Actions
BACK

In this topic

Feedback
x

Are you sure you want to log-off?