# A User's Eligibility

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

What your tenant supplied about one of its users, with who supplied each item.

## Overview

- Each item as last supplied, as [My Eligibility](https://docs.aureahub.com/docs/tok-eligibility.md) answers it, with your own `reference` and who supplied it: `suppliedBy` (the user id of the administrator who did) and `suppliedByRole`.
- `userId` must be a user of your tenant — any of them, administrators and the caller included.
- User token of one of your tenant's administrators — `owner`, `tenantadmin` or `non_signing_admin` — and the tenant signature ([Calling the Routes](https://docs.aureahub.com/docs/guide-tokenized-assets.md)). Any other role: `403` `Tenant admin access required. Your role does not have permission to perform this action.`

## 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 | — | Not one of your tenant's administrators (`Tenant admin access required. Your role does not have permission to perform this action.`). |
| 404 | TOKENIZED_ASSETS_USER_NOT_FOUND | `userId` is not a user of your tenant (`There is no such user in this tenant.`, with `details.userId`). |

## Endpoint

### `GET /v1/tokenized-assets/users/{userId}/eligibility`

Authentication: bearer token required.

What the tenant supplied about one of its users.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `userId` | string | yes | A UUID. |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | string | no | `true`: the test environment; `false` (the default): production. |

**Responses**

`200` OK

```json
{
  "userId": "3f6b2d18-0c7e-4a91-b5d3-8e2f7a1c9d64",
  "residence": {
    "country": "IT",
    "subdivision": null,
    "declaredAt": "2026-09-30T10:12:00.000Z",
    "source": "kyc",
    "suppliedAt": "2026-10-01T08:00:02.000Z",
    "reference": "KYC-2026-08812",
    "suppliedBy": "9a4c1e72-5b3d-4f08-8e6a-2c7d1b9f0e35",
    "suppliedByRole": "tenantadmin"
  },
  "usPerson": {
    "isUsPerson": false,
    "declaredAt": "2026-09-30T10:12:00.000Z",
    "source": "self_declaration",
    "suppliedAt": "2026-10-01T08:00:02.000Z",
    "reference": null,
    "suppliedBy": "9a4c1e72-5b3d-4f08-8e6a-2c7d1b9f0e35",
    "suppliedByRole": "tenantadmin"
  },
  "classification": {
    "investorClass": "retail",
    "assessedAt": "2026-09-30T10:20:00.000Z",
    "source": "mifid_classification",
    "suppliedAt": "2026-10-01T08:00:02.000Z",
    "reference": null,
    "suppliedBy": "9a4c1e72-5b3d-4f08-8e6a-2c7d1b9f0e35",
    "suppliedByRole": "tenantadmin"
  },
  "appropriateness": {
    "outcome": "appropriate",
    "assessedAt": "2026-10-07T09:41:00.000Z",
    "source": "appropriateness_test",
    "suppliedAt": "2026-10-07T09:41:05.000Z",
    "reference": "AT-551",
    "suppliedBy": "9a4c1e72-5b3d-4f08-8e6a-2c7d1b9f0e35",
    "suppliedByRole": "tenantadmin"
  }
}
```

`404` Not Your User

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "There is no such user in this tenant.",
  "details": {
    "code": "TOKENIZED_ASSETS_USER_NOT_FOUND",
    "userId": "c2d8e1f4-7a3b-4c69-9e05-1b6f8d2a7c93"
  }
}
```

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

---

Web version: https://docs.aureahub.com/#tok-user-eligibility-get