---
title: "List the caller's Sumsub IDV records"
method: GET
path: "/api/sumsub-service/v1/idv"
tags: ["Identity Verification (IDV)"]
---

# List the caller's Sumsub IDV records

`GET /api/sumsub-service/v1/idv`

Returns IDV records for the authenticated user (`user-id` header). Optional `enterpriseId` filters to that enterprise. Does not create an applicant. Empty list when the caller has no IDV, or when `enterpriseId` is set and not linked (does not leak existence). Does not refresh the WebSDK URL — call POST /v1/idv to initiate or retry.

## Query parameters

- `enterpriseId` string

## Response `200`

200

- object
  - `idvRecords` object[], required
    - `idvId` string, required
    - `status` 'pending' | 'action_required' | 'approved' | 'rejected', required
    - `verificationType` 'penny-drop' | 'video-id' | 'liveness-only' | 'deposit-verification', required
    - `userId` string, required
    - `enterpriseId` string, required
    - `organizationId` string, nullable, required
    - `rejectLabels` string[], nullable, required

## Other responses

- `400` — 400
- `403` — 403
- `500` — 500

## Changes

- **2026-09-15** `20d885ca364f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bitgo/apis/bitgo-api/changes/api/sumsub-service/v1/idv/get.md)

---

[API](https://skmtc.dev/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.dev/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitgo/apis/bitgo-api/revisions/3d2da605821b?raw)