# Get a Verification

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

One verification as it is now: its state, and what your app shows next.

## Overview

- Called from your server, signed by your tenant — the HMAC headers, or a server token of a credential whose role is `tenantadmin`, `non_signing_admin`, `auditor`, `security_admin` or `security_auditor` ([Authentication](https://docs.aureahub.com/docs/authentication.md)). The `id` is the one [Start a Verification](https://docs.aureahub.com/docs/identity-verification-create.md) answered, or the event's `verificationId`; it names its environment, so there is no `isTestnet`.
- `state`: `started`, `in_review`, `verified`, `rejected` or `expired`. `nextStep`: `start_verification`, `continue_verification`, `wait_for_review`, `approved`, `rejected` or `expired` ([Identity Verification](https://docs.aureahub.com/docs/guide-identity.md) › States and Next Step).
- `reason`: a reason code, or `null`. `aml`: `{ status }` — `PENDING`, `APPROVED`, `REJECTED` or `ESCALATED` — once a screening has a result, `null` before. Both are always in the answer.
- Never answers a link: for one, call Start a Verification again.

## Endpoint

### `GET /v1/identity/verifications/{id}`

One verification: its state and next step. Signed by your tenant.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | The verification's id (UUID) |

**Responses**

`200` In review

```json
{
  "id": "7c1e9a24-5b3d-4f8a-9e6c-2d0b4a8f1e37",
  "userId": "5d2c1b0a-9e8f-4a7b-8c6d-5e4f3a2b1c0d",
  "kind": "person",
  "purpose": "bank_ramp",
  "state": "in_review",
  "nextStep": "wait_for_review",
  "reason": "aml_review",
  "aml": {
    "status": "PENDING"
  },
  "createdAt": "2026-11-12T10:02:11.000Z",
  "updatedAt": "2026-11-12T10:09:47.000Z"
}
```

`200` Verified

```json
{
  "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"
}
```

`404` Not found

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "No such identity verification here.",
  "details": {
    "code": "IDENTITY_VERIFICATION_NOT_FOUND"
  }
}
```

---

Web version: https://docs.aureahub.com/#identity-verification-get