Skip to main content
PUT
/
embedded-banking
/
v1
/
bank-account-applications
/
{id}
Update an existing bank account application.
curl --request PUT \
  --url https://api.sandbox.tesouro.com/embedded-banking/v1/bank-account-applications/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "applicant": {
    "authentication": {
      "password": "<string>"
    },
    "birthDate": "2023-12-25",
    "firstName": "<string>",
    "hasAcceptedDisclosures": true,
    "homeAddress": {
      "address1": "<string>",
      "address2": "<string>",
      "address3": "<string>",
      "city": "<string>",
      "countryCode": "AFG",
      "postalCode": "<string>",
      "state": "<string>"
    },
    "isLegallyAuthorized": true,
    "lastName": "<string>",
    "mobilePhoneNumber": "<string>",
    "ownershipPercentage": 123,
    "personalIdentificationNumber": {
      "type": "SSN",
      "value": "<string>"
    },
    "workEmailAddress": "<string>"
  },
  "businessDetails": {
    "address": {
      "address1": "<string>",
      "address2": "<string>",
      "address3": "<string>",
      "city": "<string>",
      "countryCode": "AFG",
      "postalCode": "<string>",
      "state": "<string>"
    },
    "businessStructureType": "CORPORATION_PUBLIC",
    "dbaName": "<string>",
    "formationDate": "2023-12-25",
    "legalName": "<string>",
    "northAmericanIndustryClassificationSystemCode": "SOYBEAN_FARMING",
    "phoneNumber": "<string>",
    "taxId": {
      "type": "EIN",
      "value": "<string>"
    },
    "website": "<string>"
  },
  "businessOwners": [
    {
      "birthDate": "2023-12-25",
      "firstName": "<string>",
      "homeAddress": {
        "address1": "<string>",
        "address2": "<string>",
        "address3": "<string>",
        "city": "<string>",
        "countryCode": "AFG",
        "postalCode": "<string>",
        "state": "<string>"
      },
      "lastName": "<string>",
      "mobilePhoneNumber": "<string>",
      "ownershipPercentage": 123,
      "personalIdentificationNumber": {
        "type": "SSN",
        "value": "<string>"
      }
    }
  ],
  "individualValidationSource": "<string>",
  "organizationValidationSource": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "applicant": {
    "birthDate": "2023-12-25",
    "disclosuresAcceptedAtDateTime": "2023-11-07T05:31:56Z",
    "firstName": "<string>",
    "hasAcceptedDisclosures": true,
    "homeAddress": {
      "address1": "<string>",
      "address2": "<string>",
      "address3": "<string>",
      "city": "<string>",
      "countryCode": "AFG",
      "postalCode": "<string>",
      "state": "<string>"
    },
    "isLegallyAuthorized": true,
    "lastName": "<string>",
    "mobilePhoneNumber": "<string>",
    "ownershipPercentage": 123,
    "workEmailAddress": "<string>"
  },
  "businessDetails": {
    "address": {
      "address1": "<string>",
      "address2": "<string>",
      "address3": "<string>",
      "city": "<string>",
      "countryCode": "AFG",
      "postalCode": "<string>",
      "state": "<string>"
    },
    "businessStructureType": "CORPORATION_PUBLIC",
    "dbaName": "<string>",
    "legalName": "<string>",
    "northAmericanIndustryClassificationSystemCode": "SOYBEAN_FARMING",
    "phoneNumber": "<string>",
    "website": "<string>"
  },
  "businessOwners": [
    {
      "birthDate": "2023-12-25",
      "firstName": "<string>",
      "homeAddress": {
        "address1": "<string>",
        "address2": "<string>",
        "address3": "<string>",
        "city": "<string>",
        "countryCode": "AFG",
        "postalCode": "<string>",
        "state": "<string>"
      },
      "lastName": "<string>",
      "mobilePhoneNumber": "<string>",
      "ownershipPercentage": 123
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

The application ID.

Body

Request model for updating an existing bank account application.

​
applicant
object

Optional applicant details to update.

​
businessDetails
object

Optional business details to update.

​
businessOwners
null | object[]

Optional list of business owners (replaces all existing business owners).

​
individualValidationSource
null | string

Validation source for individual KYC (bypass-KYC partners only).

​
organizationValidationSource
null | string

Validation source for organization KYC (bypass-KYC partners only).

Response

Application updated successfully.

Response model for a bank account application.

​
id
string<uuid>
required

Unique identifier for the bank account application.

​
applicant
object

Applicant information for the bank account.

​
businessDetails
object

Business details associated with the application.

​
businessOwners
null | object[]

List of business owners associated with the application.