Get Account Owner
GET {{baseUrl}}/aggregation/v3/customers/{{customerId}}/accounts/{{accountId}}/owner
Retrieve the names and addresses of the account owner from a financial institution.
Note: this is a premium service, billable per every successful API call.
This service retrieves account data from the institution. This usually returns quickly, but in some scenarios may take a few minutes to complete. In the event of a timeout condition, retry the call.
Supported regions:
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Consent-Receipt-Id | string | (Required) A Mastercard Open Banking Consent Receipt ID | |
Accept | string | ||
App-Key | string | ||
Finicity-App-Token | string |
RESPONSES
status: OK
{"holders":[{"ownerName":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"addresses":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"relationship":"AUTHORIZED_USER","firstName":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"middleName":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"lastName":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"suffix":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"nameClassification":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"nameClassificationconfidencescore":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"emails":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"phones":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"documentations":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},{"ownerName":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"addresses":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"relationship":"AUTHORIZED_USER","firstName":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"middleName":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"lastName":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"suffix":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"nameClassification":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"nameClassificationconfidencescore":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"emails":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"phones":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"documentations":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}]}