Skip to main content
PATCH
/
embedded-banking
/
v1
/
credit-card-applications
/
{id}
Update an existing credit card application.
curl --request PATCH \
  --url https://api.sandbox.tesouro.com/embedded-banking/v1/credit-card-applications/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "applicant": {
    "hasValue": true,
    "value": {
      "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": {
    "hasValue": true,
    "value": {
      "address": {
        "address1": "<string>",
        "address2": "<string>",
        "address3": "<string>",
        "city": "<string>",
        "countryCode": "AFG",
        "postalCode": "<string>",
        "state": "<string>"
      },
      "annualBusinessRevenue": 123,
      "businessStructureType": "CORPORATION_PUBLIC",
      "companyType": "<string>",
      "dbaName": "<string>",
      "estimatedMonthlySpend": 123,
      "formationDate": "2023-12-25",
      "legalName": "<string>",
      "northAmericanIndustryClassificationSystemCode": "SOYBEAN_FARMING",
      "numberOfEmployees": 123,
      "ownership": "<string>",
      "phoneNumber": "<string>",
      "taxId": {
        "type": "EIN",
        "value": "<string>"
      },
      "website": "<string>"
    }
  },
  "businessOwners": {
    "hasValue": true,
    "value": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "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>"
        }
      }
    ]
  }
}
'
{
  "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>"
    },
    "annualBusinessRevenue": 123,
    "businessStructureType": "CORPORATION_PUBLIC",
    "companyType": "<string>",
    "dbaName": "<string>",
    "estimatedMonthlySpend": 123,
    "legalName": "<string>",
    "northAmericanIndustryClassificationSystemCode": "SOYBEAN_FARMING",
    "numberOfEmployees": 123,
    "ownership": "<string>",
    "phoneNumber": "<string>",
    "website": "<string>"
  },
  "businessOwners": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "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
    }
  ],
  "status": "DRAFT",
  "verifyBusinessStatus": "APPROVED"
}

Documentation Index

Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Application (M2M) OAuth2 access token (client credentials).

Path Parameters

​
id
string<uuid>
required

The application ID.

Body

Request model for updating an existing credit card application.

​
applicant
object

Applicant details to update. Absent = preserve; explicit value = replace.

​
businessDetails
object

Business details to update. Absent = preserve; explicit value = replace.

​
businessOwners
object

List of business owners. Absent = preserve existing owners. Explicit empty array = clear all owners. Supply an existing owner's id to merge with the stored record; omit the id for a new owner. The resulting list replaces the stored owner list.

Response

Application updated successfully.

Response model for a credit card application.

​
id
string<uuid>
required

Unique identifier for the credit card application.

​
applicant
object

Applicant information for the credit card application.

​
businessDetails
object

Business details associated with the application.

​
businessOwners
null | object[]

List of business owners associated with the application.

​
status
enum<string>

Current status of the credit card application.

Available options:
DRAFT,
SUBMITTED,
PENDING_UNDERWRITING,
APPROVED,
APPROVED_PENDING_PROVISIONING,
REJECTED,
CANCELLED
​
verifyBusinessStatus
null | enum<string>

Outcome of Alloy KYB/KYC verification performed at submission. Null on applications that have not yet been submitted.

Available options:
APPROVED,
DENIED,
MANUAL_REVIEW,
PENDING