Get Account Owner Details

7 min

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

Tab Name

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].