# An Asset's Documents

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

The documents the user reads and accepts before trading an asset, in their current version.

## Overview

- Each document's `kind`: `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 document per kind, sorted by kind: the asset's own before one that covers every asset, in the `language` asked for (two letters, default `en`) or else in English. `url` is where to show it from, `sha256` the hash of its file; `appliesTo` is `asset` for this asset's own document, `all` for one that covers every asset (a base prospectus); `validUntil` is there only for a document with an end — past it, nothing is sold until a renewed version is published.
- `accepted` says whether the user accepted this version: accept it with [Accept a Document](https://docs.aureahub.com/docs/tok-document-accept.md), sending back `kind`, `version`, `language` and `sha256` as answered here. Aurea publishes the documents; an asset with none published yet answers `documents: []`.
- User token and the tenant signature ([Calling the Routes](https://docs.aureahub.com/docs/guide-tokenized-assets.md)); every tenant role may call it.

## 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 |
| --- | --- | --- |
| 404 | TOKENIZED_ASSETS_ASSET_NOT_OFFERED | Your tenant does not offer this symbol in this environment (`This tenant does not offer this asset.`). |

## Endpoint

### `GET /v1/tokenized-assets/assets/{symbol}/documents`

Authentication: bearer token required.

The documents the user accepts before a binding quote of the asset.

**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}$`. |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | string | no | `true`: the test environment; `false` (the default): production. |
| `language` | string | no | The language wanted; a document without it is answered in English. Pattern `^[a-z]{2}$`. Default `en`. |

**Responses**

`200` OK

```json
{
  "isTestnet": false,
  "symbol": "AAPLon",
  "documents": [
    {
      "kind": "prospectus",
      "version": 2,
      "language": "en",
      "title": "Base Prospectus",
      "url": "https://docs.example-issuer.com/base-prospectus-v2.pdf",
      "sha256": "3b7f0c…64 hex characters…",
      "appliesTo": "all",
      "publishedAt": "2026-09-20T09:00:00.000Z",
      "validUntil": "2027-06-30T00:00:00.000Z",
      "accepted": true
    },
    {
      "kind": "final_terms",
      "version": 1,
      "language": "en",
      "title": "Final Terms",
      "url": "https://docs.example-issuer.com/final-terms-aapl.pdf",
      "sha256": "9e21ad…64 hex characters…",
      "appliesTo": "asset",
      "publishedAt": "2026-09-20T09:00:00.000Z",
      "accepted": false
    },
    {
      "kind": "kid",
      "version": 1,
      "language": "en",
      "title": "Key Information Document",
      "url": "https://docs.example-issuer.com/kid-aapl-en.pdf",
      "sha256": "51c04e…64 hex characters…",
      "appliesTo": "asset",
      "publishedAt": "2026-09-20T09:00:00.000Z",
      "accepted": false
    }
  ]
}
```

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

---

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