Retrieve the Account Holder for a Financial Account

Retrieve details for the account holder of a Financial Account. The account holder can be a Customer or Recipient.

Endpoint

GET /v1/financial-accounts/{financialAccountId}/accountHolder

Authorization Header

Authorization: Bearer <access_token>

Path Parameters

financialAccountId REQUIRED

string (UUID)

ID of the Financial Account.

Request Body

None

Returns

Returns the Business Customer, Individual Customer, or Recipient object. This object contains the account holder details.

SAMPLE RESPONSE

				
					{
  "customer": {
    "id": "170f5eb0-c318-465d-a365-153941ac55ff",
    "status": "ACTIVE",
    "shippingContact": {
      "shipToFirstName": "Jack",
      "shipToMiddleName": "Fred",
      "shipToLastName": "Smith"
    },
    "metadata": {
      "customerRefId": "100000333"
    },
    "createdBy": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "type": "EMPLOYEE"
    },
    "createdAt": "2022-11-23T00:42:50.311Z",
    "updatedBy": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "type": "EMPLOYEE"
    },
    "updatedAt": "2022-11-23T00:42:50.311Z",
    "type": "BUSINESS",
    "doingBusinessAsName": "ACME Corp.",
    "contacts": [
      {
        "firstName": "Jack",
        "middleName": "Fred",
        "lastName": "Smith",
        "primary": true,
        "primaryPhoneNumber": {
          "number": "+14151234",
          "type": "WORK",
          "provider": "ABC",
          "extension": "675",
          "verified": false
        },
        "primaryEmail": {
          "value": "jsmith@acme.com",
          "verified": false
        }
      }
    ]
  }
}