Skip to main content

Instant ID

InstantID validates the identity of a business and its authorized representatives. This establishes the link between a business and the authorized representatives, assessing inconsistencies that indicate fraudulent activity.

note

All API endpoints expects the request payload to be signed by the calling program with private key issued using ECDSA algorithm.

Method: POST

{{URL}}/ekyc/rpc/KycService/InstantID

Headers

NameValue
Content-Typeapplication/json

Example


curl --location --request GET '/ekyc/rpc/KycService/InstantID' \
--header 'Content-Type: application/json' \
--data '{"refId":"ABU202302141","companyName":"CITIGROUP INC","alternateCompanyName":"","ein":"088707009","phone":"2125591000","currentAddress":{"streetAddress1":"399 PARK AVE FRNT 4","city":"NEW YORK","region":"NY","postalCode":"10022","country":"USA"},"authRep":[{"name":{"firstName":"LILLIAN","lastName":"ROGERS"},"ssn":"866192951","address":{"streetAddress1":"2561 Punderson Dr","city":"Hilliard","state":"OH","zip5":"43026"},"dob":{"year":1985,"month":10,"day":13}},{"name":{"firstName":"MARK","lastName":"SMITH"},"ssn":"335889606","address":{"streetAddress1":"7 WEST END AVE","city":"JACKSONVILLE","state":"FL","zip5":"32034"},"dob":{"year":1970,"month":1,"day":1}}]}'

Body

{
"refId": "ABU202302141",
"companyName": "CITIGROUP INC",
"alternateCompanyName": "",
"ein": "088707009",
"phone": "2125591000",
"currentAddress": {
"streetAddress1": "399 PARK AVE FRNT 4",
"city": "NEW YORK",
"region": "NY",
"postalCode": "10022",
"country": "USA"
},
"authRep": [
{
"name": {
"firstName": "LILLIAN",
"lastName": "ROGERS"
},
"ssn": "866192951",
"address": {
"streetAddress1": "2561 Punderson Dr",
"city": "Hilliard",
"state": "OH",
"zip5": "43026"
},
"dob": {
"year": 1985,
"month": 10,
"day": 13
}
},
{
"name": {
"firstName": "MARK",
"lastName": "SMITH"
},
"ssn": "335889606",
"address": {
"streetAddress1": "7 WEST END AVE",
"city": "JACKSONVILLE",
"state": "FL",
"zip5": "32034"
},
"dob": {
"year": 1970,
"month": 1,
"day": 1
}
}
]
}


Response: 200


{
"applicationId": "KYC_000089173",
"refId": "ABU2023021499",
"kycStatus": {
"InstantIdStatus": "SERVICE_GOOD"
},
"businessResponse": {
"BIID20ResponseEx": {
"Response": {
"Header": {
"Status": 0,
"QueryId": "",
"TransactionId": "173107401S761970"
},
"Result": {
"NumberValidAuthRepsInput": 2,
"InputEcho": {
"Company": {
"CompanyName": "CITIGROUP INC",
"Phone": "2125591000",
"FEIN": "088707009",
"Address": {
"StreetAddress1": "399 PARK AVE FRNT 4",
"City": "NEW YORK",
"State": "NY",
"Zip5": "10022",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"BusinessIds": null,
"AlternateCompanyName": ""
},
"AuthorizedRepresentatives": {
"AuthorizedRepresentative": [
{
"Sequence": "",
"Name": {
"First": "LILLIAN",
"Last": "ROGERS",
"Full": "",
"Middle": "",
"Suffix": ""
},
"UniqueId": "3010957883",
"Address": {
"StreetAddress1": "3960 HILLMAN AVE APT 3C",
"City": "BRONX",
"State": "NY",
"Zip5": "10463",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"DOB": null,
"Phone": "",
"SSN": "666192951",
"AddressType": "",
"Age": ""
},
{
"Sequence": "",
"Name": {
"First": "ERICK",
"Last": "LEAHEY",
"Full": "",
"Middle": "JON",
"Suffix": ""
},
"UniqueId": "739762598",
"Address": {
"StreetAddress1": "16 MICHIGAN AVE APT 3",
"City": "GRAND HAVEN",
"State": "MI",
"Zip5": "95357",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"DOB": {
"Year": 1943,
"Month": 11,
"Day": 24
},
"Phone": "7144001556",
"SSN": "595609881",
"AddressType": "",
"Age": "74"
}
]
}
},
"CompanyResults": {
"VerifiedInput": {
"CompanyName": "CITIGROUP INC",
"Phone": "2125591000",
"FEIN": "088707009",
"Address": {
"StreetAddress1": "399 PARK AVE FRNT 4",
"City": "NEW YORK",
"State": "NY",
"Zip5": "10022",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"BusinessIds": null,
"AlternateCompanyName": ""
},
"VerificationIndicators": { {// Indicates whether the fields are verified or not. 0 - Not verified, 1 - Verified
"CompanyName": "1",
"StreetAddress": "1",
"City": "1",
"State": "1",
"Zip": "1",
"Phone": "1",
"FEIN": "1"
},
"BestInformation": {
"CompanyName": "CITIGROUP INC",
"Phone": "2125591000",
"FEIN": "88707009",
"Address": {
"StreetAddress1": "399 PARK AVE FRNT 4",
"City": "NEW YORK",
"State": "NY",
"Zip5": "10022",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"BusinessIds": null,
"AlternateCompanyName": ""
},
"BusinessIds": {
"DotID": 0, // Not in use
"EmpID": 0, // Not in use
"POWID": 905328,
"ProxID": 905328,
"SeleID": 905328, // ID that is assigned to a legal
"OrgID": 905328,
"UltID": 905328
},
"BusinessVerification": { {// Indicates the BVI Value. Refer definition of BVI Values in table above
"Index": "50",
"Description": "Input business name address phone and FEIN verified on a business record."
},
"RiskIndicators": {
"RiskIndicator": [
{
"RiskCode": "20",
"Description": "Unable to verify business address on business records",
"Sequence": 1
},
{
"RiskCode": "36",
"Description": "The input business phone number and business addr on record are geographically distant (> 10 miles)",
"Sequence": 2
},
{
"RiskCode": "39",
"Description": "No updates to business record in the past 24 months",
"Sequence": 3
},
{
"RiskCode": "40",
"Description": "No updates to business record in the past 12 months",
"Sequence": 4
}
]
},
"ResidentialBusinesses": {
"ResidentialBusiness": [
{
"Indicator": "2",
"Description": "Potential SOHO"
}
]
},
"BusinessToAuthorizedRepLinkIndexes": {
"BusinessToAuthorizedRepLinkIndex": [
{
"InputRepNumber": "1",
"Index": "40",
"Description": "The input authorized rep's address matches the personal address of a business contact on record."
}
]
},
"VerificationSummaries": { {// Verification based on different sources. Refer Index of definitions above
"VerificationSummary": [
{
"Type": "PHONESOURCE",
"Index": "3",
"Description": "Input Business Name Address and Phone verified"
},
{
"Type": "BUREAU",
"Index": "4",
"Description": "Input Business Name Address Phone and FEIN verified"
},
{
"Type": "GOVTREGISTRATIONS",
"Index": "3",
"Description": "Input Business Name Address and Phone verified"
},
{
"Type": "PUBLICRECORDFILINGS",
"Index": "0",
"Description": "No business inputs verified on this source"
},
{
"Type": "BUSDIRECTORIES",
"Index": "3",
"Description": "Input Business Name Address and Phone verified"
}
]
},
"Compliance": {
"SICCode": "5531",
"SICDescription": "AUTO AND HOME SUPPLY STORES",
"NAICSCode": "",
"NAICSDescription": "",
"SOSFilingName": "CITIGROUP INC",
"SOSStatus": "ACTIVE",
"TimeOnSOS": "86",
"LNStatus": "ACTIVE",
"TimeOnPublicRecord": "270",
"County": "STARK",
"BusinessFirstSeenYYYY": "1993",
"AuthorizedRepTitles": null,
"AddressRisk": null,
"Parent": {
"BusinessIds": {
"DotID": 0,
"EmpID": 0,
"POWID": 0,
"ProxID": 0,
"SeleID": 0,
"OrgID": 0,
"UltID": 0
}
}
},
"AddressRisk": {
"AddressIsPOBox": false,
"AddressIsCMRA": false
},
"NamesAddressesOfPhones": {
"NamesAddressesOfPhone": [
{
"CompanyName": "CITIGROUP INC",
"Phone": "",
"FEIN": "",
"Address": {
"StreetAddress1": "399 PARK AVE FRNT 4",
"City": "NEW YORK",
"State": "NY",
"Zip5": "10022",
"StreetPreDirection": "",
"StreetNumber": "30353",
"StreetName": "AVENIDA DE CALMA",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"BusinessIds": {
"DotID": 0,
"EmpID": 0,
"POWID": 0,
"ProxID": 0,
"SeleID": 0,
"OrgID": 0,
"UltID": 0
},
"AlternateCompanyName": ""
}
]
},
"OFACWatchLists": null
},
"AuthorizedRepresentativeResults": {
"AuthorizedRepresentativeResult": [
{
"UniqueId": "3010957883",
"AreaCodeSplitFlag": "N",
"SSNFoundForLexID": false, // Indicates if the SSN is available in LexisNexis
"NameAddressSSNSummary": 12, // Refer Table ‘InstantID Business NAS Summary’ for value definition
"NameAddressPhoneSummary": 8, // Refer Table ‘InstantID Business NAP Summary’ for value definition
"NameAddressPhoneType": "A",
"NameAddressPhoneStatus": "",
"ComprehensiveVerificationIndex": 50, // Refer CVI Values. This field can be used to validate the Authorized Representative
"DOBMatchLevel": "",
"RiskIndicators": { // Includes various risks involved with code (Refer table showing Instant ID Business Risk Codes)
"RiskIndicator": [
{
"RiskCode": "10",
"Description": "The input phone number is a mobile number",
"Sequence": 1
},
{
"RiskCode": "80",
"Description": "The input phone was missing or incomplete",
"Sequence": 2
}
]
},
"SSNInfo": {
"SSN": "666192951",
"Valid": "G",
"IssuedStartDate": {
"Year": 1983,
"Month": 1,
"Day": 0
},
"IssuedEndDate": {
"Year": 1985,
"Month": 12,
"Day": 0
},
"IssuedState": "OH",
"IssuedStateName": "Ohio"
},
"AddressRisk": {
"AddressIsPOBox": false,
"AddressIsCMRA": false
},
"InputEcho": {
"Sequence": "1",
"Name": {
"First": "LILLIAN",
"Last": "ROGERS",
"Full": "",
"Middle": "",
"Suffix": ""
},
"UniqueId": "",
"Address": {
"StreetAddress1": "3960 HILLMAN AVE APT 3C",
"City": "BRONX",
"State": "NY",
"Zip5": "10463",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"DOB": null,
"Phone": "",
"SSN": "666192951",
"AddressType": "",
"Age": ""
},
"VerifiedInput": {
"Sequence": "",
"Name": {
"First": "LILLIAN",
"Last": "ROGERS",
"Full": "",
"Middle": "",
"Suffix": ""
},
"UniqueId": "",
"Address": {
"StreetAddress1": "3960 HILLMAN AVE APT 3C",
"City": "BRONX",
"State": "NY",
"Zip5": "10463",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"DOB": null,
"Phone": "",
"SSN": "666192951",
"AddressType": "",
"Age": ""
},
"PotentialFollowupActions": {
"PotentialFollowupAction": [
{
"RiskCode": "D",
"Description": "Verify phone (Directory Assistance utility bill)",
"Sequence": 0
}
]
},
"PhoneOfNameAddress": "7185433825",
"ReversePhone": null,
"PhoneAddress": null,
"CurrentName": {
"First": "LILLIAN",
"Last": "ROGERS",
"Full": "",
"Middle": "",
"Suffix": ""
},
"ChronologyHistories": {
"ChronologyHistory": [
{
"Address": {
"StreetAddress1": "3960 HILLMAN AVE APT 3C",
"City": "BRONX",
"State": "NY",
"Zip5": "10463",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"Phone": "7185433825",
"DateFirstSeen": {
"Year": 2008,
"Month": 11,
"Day": 0
},
"DateLastSeen": {
"Year": 2016,
"Month": 11,
"Day": 0
},
"IsBestAddress": false
},
{
"Address": {
"StreetAddress1": "2747 22ND ST NE",
"City": "CANTON",
"State": "OH",
"Zip5": "44705",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"Phone": "",
"DateFirstSeen": {
"Year": 1998,
"Month": 3,
"Day": 0
},
"DateLastSeen": {
"Year": 2008,
"Month": 11,
"Day": 0
},
"IsBestAddress": false
},
{
"Address": {
"StreetAddress1": "1615 15TH ST NE APT 4",
"City": "CANTON",
"State": "OH",
"Zip5": "44705",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"Phone": "",
"DateFirstSeen": {
"Year": 2005,
"Month": 12,
"Day": 0
},
"DateLastSeen": {
"Year": 2005,
"Month": 12,
"Day": 0
},
"IsBestAddress": false
}
]
},
"AKAs": null
},
{
"UniqueId": "739762598",
"AreaCodeSplitFlag": "N",
"SSNFoundForLexID": false,
"NameAddressSSNSummary": 9,
"NameAddressPhoneSummary": 12,
"NameAddressPhoneType": "P",
"NameAddressPhoneStatus": "C",
"ComprehensiveVerificationIndex": 50,
"DOBMatchLevel": "8",
"RiskIndicators": null,
"SSNInfo": {
"SSN": "595609881",
"Valid": "G",
"IssuedStartDate": {
"Year": 1961,
"Month": 1,
"Day": 0
},
"IssuedEndDate": {
"Year": 1963,
"Month": 12,
"Day": 0
},
"IssuedState": "OH",
"IssuedStateName": "Ohio"
},
"AddressRisk": {
"AddressIsPOBox": false,
"AddressIsCMRA": false
},
"InputEcho": {
"Sequence": "2",
"Name": {
"First": "ERICK",
"Last": "LEAHEY",
"Full": "",
"Middle": "JON",
"Suffix": ""
},
"UniqueId": "",
"Address": {
"StreetAddress1": "16 MICHIGAN AVE APT 3",
"City": "GRAND HAVEN",
"State": "MI",
"Zip5": "95357",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"DOB": {
"Year": 1943,
"Month": 11,
"Day": 24
},
"Phone": "7144001556",
"SSN": "595609881",
"AddressType": "",
"Age": "74"
},
"VerifiedInput": {
"Sequence": "",
"Name": {
"First": "ERICK",
"Last": "LEAHEY",
"Full": "",
"Middle": "",
"Suffix": ""
},
"UniqueId": "",
"Address": {
"StreetAddress1": "16 MICHIGAN AVE APT 3",
"City": "GRAND HAVEN",
"State": "MI",
"Zip5": "95357",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"DOB": {
"Year": 1943,
"Month": 11,
"Day": 24
},
"Phone": "7144001556",
"SSN": "595609881",
"AddressType": "",
"Age": ""
},
"PotentialFollowupActions": null,
"PhoneOfNameAddress": "9419249348",
"ReversePhone": {
"Name": {
"First": "ERICK",
"Last": "LEAHEY",
"Full": "",
"Middle": "",
"Suffix": ""
},
"Address": {
"StreetAddress1": "16 MICHIGAN AVE APT 3",
"City": "",
"State": "",
"Zip5": "",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
}
},
"PhoneAddress": {
"StreetAddress1": "16 MICHIGAN AVE APT 3",
"City": "GRAND HAVEN",
"State": "MI",
"Zip5": "95357",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"CurrentName": {
"First": "ERICK",
"Last": "LEAHEY",
"Full": "",
"Middle": "",
"Suffix": ""
},
"ChronologyHistories": {
"ChronologyHistory": [
{
"Address": {
"StreetAddress1": "16 MICHIGAN AVE APT 3",
"City": "GRAND HAVEN",
"State": "MI",
"Zip5": "95357",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"Phone": "9419249348",
"DateFirstSeen": {
"Year": 2008,
"Month": 11,
"Day": 0
},
"DateLastSeen": {
"Year": 2015,
"Month": 12,
"Day": 0
},
"IsBestAddress": false
},
{
"Address": {
"StreetAddress1": "8632 DOLCE LN",
"City": "SARASOTA",
"State": "FL",
"Zip5": "34238",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"Phone": "9419258092",
"DateFirstSeen": {
"Year": 2002,
"Month": 6,
"Day": 0
},
"DateLastSeen": {
"Year": 2009,
"Month": 5,
"Day": 0
},
"IsBestAddress": false
},
{
"Address": {
"StreetAddress1": "4023 SAWYER RD UNIT 104",
"City": "SARASOTA",
"State": "FL",
"Zip5": "34233",
"StreetPreDirection": "",
"StreetNumber": "",
"StreetName": "",
"StreetSuffix": "",
"UnitDesignation": "",
"UnitNumber": ""
},
"Phone": "9413567612",
"DateFirstSeen": null,
"DateLastSeen": {
"Year": 2016,
"Month": 11,
"Day": 0
},
"IsBestAddress": false
}
]
},
"AKAs": null
}
]
},
"Models": {
"Model": [
{
"Name": "",
"Scores": {
"Score": [
{
"Type": "0-999",
"Value": 0,
"RiskIndices": {
"RiskIndex": null
},
"HighRiskIndicators": {
"HighRiskIndicator": null
}
}
]
}
},
{
"Name": "",
"Scores": {
"Score": [
{
"Type": "0-999",
"Value": 0,
"RiskIndices": {
"RiskIndex": null
},
"HighRiskIndicators": {
"HighRiskIndicator": null
}
}
]
}
}
]
}
}
}
}
},
"fee": 1,
"accountInfo": {
"apiCallCost": 1,
"balance": 9889
}
}