---
title: "Get Users Requiring ID Verification – Retrieves a list of users who require identity verification (IDV) for a given account."
method: GET
path: "/programs/{programCode}/accounts/{accountIdentifier}/users/kycGates/idv"
tags: ["Users"]
---

# Get Users Requiring ID Verification – Retrieves a list of users who require identity verification (IDV) for a given account.

`GET /programs/{programCode}/accounts/{accountIdentifier}/users/kycGates/idv`

Retrieves a list of users who require identity verification (IDV) for the specified account. Returns the list of users and their verification status.

## Path parameters

- `programCode` string, required
- `accountIdentifier` string, required

## Headers

- `X-GD-RequestId` string, required

## Response `200`

OK

- GetUsersRequireIDVResponse — Represents the response returned after retrieving users associated with an account who require identity verification (IDV). Inherits standard response metadata and details from Gd.Bos.DataTransfer.Response.ResponseBase. Contains a list of users who need to complete IDV, including their identifiers and basic profile information. Used to communicate which users on an account must complete identity verification for compliance, onboarding, or risk management processes.
  - `users` IDVRequiredUsersModel[], nullable — A list of users who require identity verification, each represented by an Gd.Bos.DataTransfer.Response.Business.IDVRequiredUsersModel.
    - `useridentifier` string, nullable — The unique identifier of the user who requires identity verification. Must be a valid GUID associated with the user.
    - `firstname` string, nullable — The first name of the user who requires identity verification.
    - `lastname` string, nullable — The last name of the user who requires identity verification.
    - `isprimaryaccountholder` string, nullable — Indicates whether the user is the primary account holder. Expected values: "true" or "false" (as a string).
  - `responseDetails` ResponseDetail[], nullable — Required: A list of response details providing status codes, descriptions, and additional information about the result of the operation.
    - `code` integer — The primary status or error code for the response (e.g., 200 for success, 400 for validation error).
    - `subCode` integer, nullable — An optional subcode providing more granular detail about the response or error.
    - `description` string, nullable — A human-readable description of the response, error, or status.
    - `url` string, nullable — A URL linking to documentation or a web page with more information about the response code.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/greendot/apis/baas-apis.md) · [All operations](https://skmtc.net/greendot/apis/baas-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/greendot/baas-apis/versions/666553766b78/schema)