# A User's Verifications

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

Every verification of one of your users in one environment, newest first: the live ones, and the earlier ones a new start replaced.

## Overview

- Called from your server, signed by your tenant — the HMAC headers, or a server token of a credential whose role reads users (as [Get a Verification](https://docs.aureahub.com/docs/identity-verification-get.md)) —, in one environment (`isTestnet`).
- `verifications`: each as Get a Verification answers it, newest first; a replaced one stays listed after the one that replaced it. A user with none answers an empty list: start one with [Start a Verification](https://docs.aureahub.com/docs/identity-verification-create.md).
- Use it to show the user where they stand when your app opens, or to reconcile after a missed event. Never answers a link.

## Endpoint

### `GET /v1/identity/subjects/{userId}/verifications`

A user's verifications in one environment, newest first. Signed by your tenant.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `userId` | string | yes | One of your tenant's users (UUID) |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | boolean | no | `true` for the sandbox; `false` or omitted for production |

**Responses**

`200` Verifications

```json
{
  "verifications": [
    {
      "id": "7c1e9a24-5b3d-4f8a-9e6c-2d0b4a8f1e37",
      "userId": "5d2c1b0a-9e8f-4a7b-8c6d-5e4f3a2b1c0d",
      "kind": "person",
      "purpose": "bank_ramp",
      "state": "verified",
      "nextStep": "approved",
      "reason": null,
      "aml": {
        "status": "APPROVED"
      },
      "createdAt": "2026-11-12T10:02:11.000Z",
      "updatedAt": "2026-11-12T10:31:05.000Z"
    },
    {
      "id": "2a9d4f61-8c3b-4e7a-b5d0-6f1e3c8a9b24",
      "userId": "5d2c1b0a-9e8f-4a7b-8c6d-5e4f3a2b1c0d",
      "kind": "person",
      "purpose": "bank_ramp",
      "state": "rejected",
      "nextStep": "rejected",
      "reason": "failed",
      "aml": null,
      "createdAt": "2026-11-11T16:30:02.000Z",
      "updatedAt": "2026-11-11T16:44:20.000Z"
    }
  ]
}
```

`404` Not your user

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "No such user in this tenant.",
  "details": {
    "code": "IDENTITY_SUBJECT_NOT_FOUND"
  }
}
```

---

Web version: https://docs.aureahub.com/#identity-subject-verifications