---
title: "Read the canonical verification state for the session customer"
method: GET
path: "/compliance/status"
tags: ["Compliance"]
---

# Read the canonical verification state for the session customer

`GET /compliance/status`

## Request

- Base URL: `https://v1.orchestrator.rhinestone.dev/deposit-processor`
- URL: `https://v1.orchestrator.rhinestone.dev/deposit-processor/compliance/status`
- Auth: none declared. Required headers: `authorization`
- TypeScript: <https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/docs/compliance/status/get.ts> (a function with typed inputs; its response is checked against the schema)

Browser route. Returns the normalized verification state for the compliance customer named by the session bearer. Scoped to that one customer — a token can never read another customer, project, or bound account.

## Headers

- `authorization` string, required: Bearer <scoped compliance session token>

## Response `200`

Normalized verification state

- ComplianceStatusResponse
  - `status` 'not_started' | 'pending' | 'approved' | 'declined', required
  - `updatedAt` string, required: ISO-8601 timestamp of the last status change.
  - `verification` object
    - `actionsRequired` string[], required: Outstanding customer actions; resume hosted verification to complete them.
    - `entities` object[], required
      - `entity` string, required: Provider jurisdiction, e.g. Us, Lt.
      - `status` 'Pending' | 'Approved' | 'Declined', required
      - `model` string, required
      - `rejectType` 'Final' | 'Retry': Present on a declined entity; Retry means the customer can resubmit.
    - `agreements` object[], required
      - `name` string, required
      - `version` integer, required
      - `accepted` boolean, required

## Other responses

- `401`: Missing, malformed, or expired session token
- `403`: Session does not match the resolved customer
- `500`: Failed to read compliance status

## Changes

- **2026-09-17** `676300ac19ff`: 3 warning, 4 info
  - added the new `approved` enum value to the `status` response property for the response status `200`
  - added the new `declined` enum value to the `status` response property for the response status `200`
  - added the new `pending` enum value to the `status` response property for the response status `200`
  - added the optional property `code` to the response with the `401` status
  - …3 more
- **2026-09-14** `b214307f591f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/changes/compliance/status/get.md)

---

[API](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api.md) - [All operations](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/revisions/aa1767d704fa?raw)