# Share a KYC Applicant

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

With the `identity_sharing` strategy: hand the bank ramp the applicant your tenant already verified, instead of sending the details and identity checks again.

## Overview

- **With the `identity_sharing` strategy only** (`403` `BANK_RAMP_KYC_STRATEGY_OFF` otherwise), **for a personal customer**: a company's answers `409` `BANK_RAMP_CUSTOMER_KIND_MISMATCH`.
- `token` is the applicant's share token, issued by your tenant's KYC vendor account for the bank ramp: printable characters without spaces, at most 512. Any other value answers `400` `BANK_RAMP_KYC_DATA_INVALID` with `fields: ["token"]`. Aurea passes it on and never keeps or logs it.
- `202` with `accepted: "share"`: the bank ramp reads the applicant's details and verifications with the token and moves the sections it can fill to review. Then send the [risk form](https://docs.aureahub.com/docs/bank-customer-form.md) and the `sourceOfFunds` [verification](https://docs.aureahub.com/docs/bank-customer-verifications.md).
- The KYC on, a confirmed customer, the bank ramp's refusals: as in [Send Details](https://docs.aureahub.com/docs/bank-customer-details.md).

## Endpoint

### `POST /v1/ramp/bank/customer/share`

Authentication: bearer token required.

Shares the customer's verified KYC applicant with the bank ramp.

**Request body**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `token` | string | yes | The applicant's share token, 1 to 512 printable characters without spaces |
| `isTestnet` | boolean | no | `true` for the sandbox; `false` or omitted for production |

**Responses**

`202` Accepted

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

`409` A company

```json
{
  "statusCode": 409,
  "error": "ConflictError",
  "message": "The bank ramp takes a shared applicant for a personal customer only.",
  "details": { "code": "BANK_RAMP_CUSTOMER_KIND_MISMATCH", "environment": "sandbox", "kind": "corporate" }
}
```

---

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