Get Account Owner Details
Introduction
The "Get Account Owner Details" API by Signzy is integrated with Finicity. This helps you fetch the account owner details of a bank account which can be used to verify the bank account owner's information for your onboarding process.
API Input Guidelines
This API takes two inputs -
- CustomerID
- AccountID
To get the above two IDs, you'll have to create a customer and finicity journey for them to go through. Once a customer is made using the "Create Bank Connect journey link" API, and the results about the Customer ID and the accountIDs are with you, you can run this API for each account to verify the owner's details.
Sample cURL
curl --location --request POST 'https://api-preproduction.signzy.app/api/v3/bank-connect/account-owner' \
--header 'Authorization: <Token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"customerId": "6018678884",
"accountId": "6032346608"
}'Input Parameters
Parameter name | Data type | Required | Description |
|---|---|---|---|
Authorization | Authorization token | Yes | Authorization token sent in the header |
Content-Type | application/json(fixed) | Yes | Sent in the headers |
customerId | string | Yes | The customer Id which was created and sent in the response after running create bank connect journey API |
accountId | string | Yes | The account Id for a specific account of the customer sent in response of the Create bank connect journey |
Sample Response
{
"result": {
"holders": [
{
"ownerName": "JOHN DOE",
"nameClassification": "business",
"nameClassificationconfidencescore": 0.7686,
"addresses": [
{
"ownerAddress": "924 GAINSVILLE HIGHWAY SUITE 130 BUFORD, GA 30518"
}
]
}
]
}
}Output Parameters
Parameter name | Data type | Description |
|---|---|---|
result.holders | Nested Object | List of all the account holders |
holders.ownerName | string | Account holder name |
holders.nameClassification | string | Account holder type |
holders.nameClassificationconfidencescore | float | Confidence score of the account holder type classification |
holders.addresses | nested object | List of available addresses of the account owner |
addresses.ownerAddress | string | Account holder address |
Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.
You can reach out to us at [email protected].