Get Account Owner Details (cloned)

introduction the "get account owner details" api facilitates the retrieval of account owner information for bank accounts this integration is specifically designed to aid in verifying the identity and details of the bank account owner during the onboarding process by utilizing this service, you can access a comprehensive range of data objects pertaining to the account holder and their bank account these data objects include information about the account holder, the classification of the account, the associated score for the account classification, as well as any available addresses associated with the account it is important to note that the specific data returned by the api may vary depending on the financial institution, as not all institutions provide the same set of data supported regions us api details this api requires two inputs customerid the unique identifier for the customer accountid the unique identifier for the account to obtain the required ids, you need to follow these steps create a customer and initiate the finicity journey for them by using the create bank connect journey link docid\ nckrwlah4pry52vphhnpc api retrieve the results from the api to obtain the customer id and the corresponding account ids execute this api for each individual account to verify the owner's details please note that the customer and finicity journey need to be created beforehand in order to obtain the necessary ids sample curl curl location request post 'https //api signzy app/api/v3/bank connect/account owner' \\ \ header 'authorization \<token>' \\ \ header 'content type application/json' \\ \ data raw '{ "customerid" "6018678884", "accountid" "6032346608" }'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" }' request body parameters parameter name data type required description customerid string yes the customer id which was obtained in the response of create bank connect journey link docid\ nckrwlah4pry52vphhnpc api this is c ustomer id of the customer account whose owner details are to be fetched accountid string yes the account id for a specific account of the customer obtained in the response of create bank connect journey link docid\ nckrwlah4pry52vphhnpc api this is a ccount id of the customer account whose owner details are to be fetched sample response { "result" { "holders" \[ { "ownername" "john doe", "nameclassification" "business", "nameclassificationconfidencescore" 0 7686, "addresses" \[ { "owneraddress" "434 w ascension way", "type" "home", "line1" "434 w ascension way", "line2" "suite #200", "line3" "ut 84123", "city" "murray", "state" "ut", "postalcode" "84123", "country" "usa" } ] } ] } } response body parameters parameter name data type description result holders array\[ accountownerdetails ] list of all the account owners holders ownername string the full name of the account owner multiple account owners are returned in one string per the source data from the institution example "john smith, phd" holders nameclassification string the classification of the account holder "person / personal / home" "business" "other" example "person" holders nameclassificationconfidencescore float the confidence score 0 1 of the name classification example 0 81 holders addresses array\[ accountowneraddress ] list of available addresses of the account owner addresses owneraddress string account owner address sample error { "error" { "name" "error", "message" "invalid date", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" 200 } } error response parameters parameter description error this parameter contains the error error name the name of the error error message the error message error status status of the api error reason reason for error error type type of the error error statuscode request status code from signzy 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 help\@signzy com we strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively we value your feedback and are committed to making your experience smooth and enjoyable our team is dedicated to assisting you with any needs you may have thank you for choosing our services we look forward to helping you!