# Accept an Asset's Document

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

Records that the user accepted the document they were shown.

## Overview

- Send `kind`, `version`, `language` and `sha256` exactly as [Asset Documents](https://docs.aureahub.com/docs/tok-documents.md) answered them. Anything else than the current text — an old version, another hash, another language than the one the document was answered in (asked in `it`, answered in English: send `en`) — answers `409` `TOKENIZED_ASSETS_DOCUMENT_MISMATCH` with the current `currentVersion` and `currentLanguage`, and nothing is recorded.
- `201` the first time; accepting the same version again answers `200` with the first `acceptedAt`. An acceptance is the user's and the version's: a new version asks the user again.
- User token and the tenant signature ([Calling the Routes](https://docs.aureahub.com/docs/guide-tokenized-assets.md)); for `user`, `owner`, `tenantadmin` and `signer`, for themselves (another role: `403`).

## Errors

Besides [the answers every tokenized assets route can give](https://docs.aureahub.com/docs/guide-tokenized-assets.md) (no valid token or signature, the module not set up or not switched on, a field that does not fit):

| Status | details.code | When |
| --- | --- | --- |
| 403 | — | The caller's role may not call it (`Your role does not have permission to perform this action.`). |
| 404 | TOKENIZED_ASSETS_ASSET_NOT_OFFERED | Your tenant does not offer this symbol in this environment (`This tenant does not offer this asset.`). |
| 404 | TOKENIZED_ASSETS_DOCUMENT_NOT_FOUND | The asset has no published document of this kind in that language (`This asset has no published document of this kind.`, with `details.symbol` and `details.kind`). |
| 409 | TOKENIZED_ASSETS_DOCUMENT_MISMATCH | Not the current version, language or file (`This is not the asset's current document: read it again and accept that one.`). |

## Endpoint

### `POST /v1/tokenized-assets/assets/{symbol}/documents/acceptances`

Authentication: bearer token required.

Records the user's acceptance of the document they were shown.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | yes | The token's symbol, as its contract names it (case matters). Pattern `^[A-Za-z0-9.-]{1,32}$`. |

**Request body**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | boolean | no | `true` for the test environment; `false` (the default) for production. |
| `kind` | string | yes | prospectus, final_terms, kid (key information document), prospectus_supplement, or a risk disclosure: risk_issuer_control (the issuer can move or freeze tokens), risk_upgradeable_contracts, risk_securities_lending (the underlying shares may be lent), risk_product_closure, risk_leverage (leveraged and inverse products). One of `prospectus`, `final_terms`, `kid`, `prospectus_supplement`, `risk_issuer_control`, `risk_upgradeable_contracts`, `risk_securities_lending`, `risk_product_closure`, `risk_leverage`. |
| `version` | integer | yes |  |
| `language` | string | yes | ISO 639-1, lower case. Pattern `^[a-z]{2}$`. |
| `sha256` | string | yes | The SHA-256 of the file, in hex. Pattern `^[0-9a-fA-F]{64}$`. |

**Responses**

`201` Accepted

```json
{
  "symbol": "AAPLon",
  "kind": "final_terms",
  "version": 1,
  "language": "en",
  "acceptedAt": "2026-10-07T15:01:12.000Z"
}
```

`200` Accepted Before

```json
{
  "symbol": "AAPLon",
  "kind": "final_terms",
  "version": 1,
  "language": "en",
  "acceptedAt": "2026-10-07T15:01:12.000Z"
}
```

`409` Not the Current Text

```json
{
  "statusCode": 409,
  "error": "ConflictError",
  "message": "This is not the asset's current document: read it again and accept that one.",
  "details": {
    "code": "TOKENIZED_ASSETS_DOCUMENT_MISMATCH",
    "symbol": "AAPLon",
    "kind": "final_terms",
    "currentVersion": 2,
    "currentLanguage": "en"
  }
}
```

[Contact us for details](https://www.aureahub.com/contact).

---

Web version: https://docs.aureahub.com/#tok-document-accept