# Send the Customer's Risk Form

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

Send what the customer does, where their money comes from, how much they expect to move and where they pay tax.

## Overview

- With the `reliance` and the `identity_sharing` strategies; with `hosted_oauth`, `403` `BANK_RAMP_KYC_STRATEGY_OFF`.
- The rules of [Send Details](https://docs.aureahub.com/docs/bank-customer-details.md) apply: the KYC on, a confirmed customer of the kind the body names, exactly one of `personal` and `corporate`, checked and never repaired, refused with field names only (`400` `BANK_RAMP_KYC_DATA_INVALID`), `202` with `accepted: "form"`, nothing kept.

## Endpoint

### `PATCH /v1/ramp/bank/customer/form`

Authentication: bearer token required.

Sends the customer's risk form to the bank ramp for review.

**Request body**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | boolean | no | `true` for the sandbox; `false` or omitted for production |
| `personal` | object | no | A person's form. Exactly one of `personal` and `corporate` |
| `personal.occupation` | string | yes | `OCCUPATION_STUDENT`, `OCCUPATION_EMPLOYED`, `OCCUPATION_SELF_EMPLOYED`, `OCCUPATION_UNEMPLOYED`, `OCCUPATION_RETIRED` |
| `personal.profession` | string | yes | `PROFESSION_ACCOUNTANCY`, `PROFESSION_ADMINISTRATIVE`, `PROFESSION_AGRICULTURE`, `PROFESSION_ARTS_ENTERTAINMENT_MEDIA`, `PROFESSION_BROKER_DEALER`, `PROFESSION_CATERING_HOSPITALITY_TOURISM`, `PROFESSION_CHARITY`, `PROFESSION_CONSTRUCTION_REAL_ESTATE`, `PROFESSION_DEALER_HIGH_VALUE_GOODS`, `PROFESSION_DEALER_PRECIOUS_METALS`, `PROFESSION_EDUCATION`, `PROFESSION_EMERGENCY_SERVICES`, `PROFESSION_EXTRACTIVE_INDUSTRY`, `PROFESSION_FINANCIAL_SERVICES_BANKING`, `PROFESSION_FINANCIAL_SERVICES_INSURANCE`, `PROFESSION_FINANCIAL_SERVICES_OTHER`, `PROFESSION_FINANCIAL_SERVICES_PRIVATE_BANKING`, `PROFESSION_GAMBLING`, `PROFESSION_GOVERNMENT`, `PROFESSION_HEALTH_CARE`, `PROFESSION_INFORMATION_TECHNOLOGY`, `PROFESSION_LEGAL`, `PROFESSION_MANUFACTURING`, `PROFESSION_MARKETING`, `PROFESSION_MILITARY`, `PROFESSION_MONEY_SERVICE_BUSINESS`, `PROFESSION_PENSIONER`, `PROFESSION_PUBLIC_PROCUREMENT`, `PROFESSION_RETAIL_SALES` |
| `personal.fundOrigin` | string | yes | `FUND_ORIGIN_SALARY`, `FUND_ORIGIN_DIVIDENDS`, `FUND_ORIGIN_INHERITANCE`, `FUND_ORIGIN_SAVINGS`, `FUND_ORIGIN_INVESTMENT`, `FUND_ORIGIN_GIFT`, `FUND_ORIGIN_MINING`, `FUND_ORIGIN_REAL_ESTATE`, `FUND_ORIGIN_LOAN` |
| `personal.annualIncome` | string | yes | `ANNUAL_INCOME_UNDER_10K`, `ANNUAL_INCOME_FROM_10K_TO_50K`, `ANNUAL_INCOME_FROM_50K_TO_150K`, `ANNUAL_INCOME_FROM_150K_TO_300K`, `ANNUAL_INCOME_MORE_THAN_300K` |
| `personal.monthlyTurnover` | string | yes | `TURNOVER_UNDER_10K`, `TURNOVER_10K_TO_50K`, `TURNOVER_50K_TO_150K`, `TURNOVER_150K_TO_500K`, `TURNOVER_MORE_THAN_500K` |
| `personal.monthlyTransactionCount` | string | yes | `TRANSACTION_COUNT_UNDER_5`, `TRANSACTION_COUNT_5_TO_50`, `TRANSACTION_COUNT_50_TO_100`, `TRANSACTION_COUNT_100_TO_200`, `TRANSACTION_COUNT_MORE_THAN_200` |
| `personal.activities` | string[] | yes | Any of `ACTIVITY_COMMERCE_SELLING`, `ACTIVITY_COMMERCE_BUYING`, `ACTIVITY_INVESTING_CRYPTO`, `ACTIVITY_OTHER`; may be empty |
| `personal.activityOther` | string | no | What the other activity is, at most 500 characters |
| `personal.publicFunction` | boolean | yes | Whether the person holds a public function |
| `personal.fundOwner` | boolean | yes | Whether the person owns the funds |
| `personal.usCitizen` | boolean | yes |  |
| `personal.usTaxPerson` | boolean | yes |  |
| `personal.tin` | string | yes | Tax identification number, at most 50 characters |
| `personal.taxResidenceCountry` | string | yes | Two-letter country code |
| `corporate` | object | no | A company's form |
| `corporate.service` | string | yes | What the company uses the service for, at most 500 characters |
| `corporate.legalForm` | string | no | `LEGAL_FORM_PUBLIC_LIMITED`, `LEGAL_FORM_PRIVATE_LIMITED`, `LEGAL_FORM_PARTNERSHIPS`, `LEGAL_FORM_SOLE_TRADERS_PROPRIETORSHIPS`, `LEGAL_FORM_PUBLIC_AUTHORITIES`, `LEGAL_FORM_NON_PROFIT`, `LEGAL_FORM_BRANCHES`, `LEGAL_FORM_OTHER` |
| `corporate.purpose` | string | yes | `PURPOSE_COLLECTING_PAYMENTS`, `PURPOSE_PAYING_FOR_GOODS`, `PURPOSE_BUY_SELL_CRYPTO_CURRENCIES`, `PURPOSE_ENGAGE_IN_DEFI`, `PURPOSE_OTHER` |
| `corporate.activity` | string | yes | `ACTIVITY_ACCOMMODATION_FOOD_TRAVEL`, `ACTIVITY_ACCOUNTING_LEGAL_CONSULTANCY`, `ACTIVITY_ADULT_ENTERTAINMENT`, `ACTIVITY_ADVERTISING`, `ACTIVITY_AGRICULTURE`, `ACTIVITY_ARTS_ENTERTAINMENT`, `ACTIVITY_CHARITY`, `ACTIVITY_CONSTRUCTION`, `ACTIVITY_DEALER_HIGH_VALUE_GOODS`, `ACTIVITY_ECOMMERCE`, `ACTIVITY_EDUCATION`, `ACTIVITY_EXTRACTIVE_INDUSTRY`, `ACTIVITY_GAMBLING`, `ACTIVITY_HEALTH_SERVICES`, `ACTIVITY_MANUFACTURING`, `ACTIVITY_MARKETPLACE`, `ACTIVITY_MEDIA`, `ACTIVITY_MULTI_LEVEL_MARKETING`, `ACTIVITY_PERSONAL_INVESTMENT`, `ACTIVITY_PUBLIC_SECTOR`, `ACTIVITY_REAL_ESTATE`, `ACTIVITY_RETAIL`, `ACTIVITY_SOCIAL_WORK`, `ACTIVITY_SOFTWARE_TECHNOLOGY`, `ACTIVITY_TELECOM`, `ACTIVITY_TRANSPORTATION`, `ACTIVITY_UTILITIES`, `ACTIVITY_CRYPTO_SERVICES`, `ACTIVITY_FINANCIAL_INSTITUTION`, `ACTIVITY_OTHER` |
| `corporate.fundOrigin` | string | yes | `FUND_ORIGIN_REVENUE`, `FUND_ORIGIN_PROFIT_DIVIDENDS`, `FUND_ORIGIN_LOAN`, `FUND_ORIGIN_INVESTMENTS`, `FUND_ORIGIN_CUSTOMER_FUNDS`, `FUND_ORIGIN_THIRD_PARTIES_FUNDS` |
| `corporate.monthlyTurnover` | string | yes | `TURNOVER_UNDER_100K`, `TURNOVER_100K_TO_250K`, `TURNOVER_MORE_THAN_250K` |
| `corporate.monthlyTransactionCount` | string | yes | `TRANSACTION_COUNT_UNDER_100`, `TRANSACTION_COUNT_100_TO_250`, `TRANSACTION_COUNT_MORE_THAN_250` |

**Responses**

`202` Accepted

```json
{
  "environment": "sandbox",
  "customer": { "customerId": "2f6c1e84-5b3a-4d97-8e21-0c4a7b9d3f15", "kind": "personal", "state": "incomplete", "…": "…" },
  "verification": {
    "state": "incomplete",
    "nextStep": "continue_onboarding",
    "missing": ["form", "verifications"],
    "kycStrategy": "reliance"
  },
  "accepted": "form"
}
```

`400` Not valid

```json
{
  "statusCode": 400,
  "error": "BadRequestError",
  "message": "The KYC data is not valid: correct the fields named and send it again.",
  "details": { "code": "BANK_RAMP_KYC_DATA_INVALID", "fields": ["personal.annualIncome"] }
}
```

---

Web version: https://docs.aureahub.com/#bank-customer-form