Account Holders

Learn how to register your end user customers or businesses as an Account Holder.

Account Holder

1. Create Account Holder

πŸ“˜

Note the response's id attribute for account creation. You'll also see duplicate fields below for backwards compatibility as we move towards consistent field naming conventions in our API.

POST https://sandbox.conduit.financial/account-holders

{
  "data": {
    "type": "account-holder",
    "attributes": {
      "businessName": "Pear Inc.",
      "firstName": "John", // If Business, enter legal representatives info.
      "lastName": "Smith", // If Business, enter legal representatives info.
      "middleName": "Marvin", // If Business, enter legal representatives info.
      "address": {
        "streetNumber": "55",
        "streetName": "Jump Street",
        "aptUnitSuiteFloor": "Apt 21",
        "city": "Santiago",
        "stateProvince": "RM",
        "postalCode": "1000000",
        "country": "CL"
      },
      "dateOfBirth": "2019-08-24", // If Business, enter date of incorporation.
      "nationality": "CL", // If Business, enter country of incorporation.
      "taxNumber":"775885567",
      "email":"[email protected]",
      "phone":"+56912345678",
      "externalId": "null"
    }
  }
}
{
    "data": {
        "id": "id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0",
        "type": "account-holder",
        "attributes": {
            "externalId": "null",
            "firstName": "John",
            "lastName": "Smith",
            "middleName": "Marvin",
            "verificationStatus": "pending",
            "taxNumber": "775885567",
            "businessName": "Pear Inc.",
            "phone": "+56912345678",
            "email": "[email protected]",
            "address": {
                "streetNumber": "55",
                "streetName": "Jump Street",
                "street": "Jump Street",
                "aptUnitSuiteFloor": "Apt 21",
                "apt_suite_flat_etc": "Apt 21",
                "city": "Santiago",
                "stateProvince": "RM",
                "postalCode": "1000000",
                "postal_zip_code": "1000000",
                "country": "CHL"
            },
            "dateOfBirth": "2019-08-24",
            "nationality": "CHL"
        },
        "relationships": {
            "accounts": {
                "links": {
                    "self": "/account-holders/id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0/relationships/accounts",
                    "first": "/account-holders/id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0/relationships/accounts",
                    "next": null,
                    "related": "/account-holders/id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0/accounts",
                    "prev": null
                },
                "data": []
            }
        }
    }
}

2. Change Compliance Status

In our Sandbox environment ONLY, you can simulate various sanctions screening scenarios by altering the account holder's compliance status. In our Live environment, sanctions screening is automated and you will not need to or be able to simulate different scenarios.

Learn more about our sanctions screening process here.

πŸ“˜

Newly created Account Holders will start off as pending so in order to successfully create an account or transaction in Sandbox, you'll need to use the compliance simulation endpoint below to change the status to approved first.

POST https://sandbox.conduit.financial/simulator/compliance

  • Replace the Account Holder id with the one you noted down.
  • Change complianceStatus to approved.
{
  "data": {
    "type": "account-holder",
    "attributes": {
      "id": "id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0",
      "complianceStatus": "approved"
    }
  }
}

What’s Next

Now that you've successfully created your first Account Holder, let's create an account.