---
title: "Add IDV Socure Result – Validates user’s identification documents uploaded via Doc V SDK."
method: POST
path: "/programs/{programCode}/accounts/{accountIdentifier}/users/{userIdentifier}/kycGates/idvsocure"
tags: ["Kyc"]
---

# Add IDV Socure Result – Validates user’s identification documents uploaded via Doc V SDK.

`POST /programs/{programCode}/accounts/{accountIdentifier}/users/{userIdentifier}/kycGates/idvsocure`

Validates user’s identification documents uploaded via Doc V SDK. Returns KYC state data.

## Path parameters

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

## Headers

- `X-GD-RequestId` string, required
- `X-GD-ApiVersion` string

## Request body

- IDVSocureRequest — Represents a request to validate a user's identification documents uploaded via Doc V SDK.
  - `fraudData` object, nullable — Optional fraud data for additional verification.
  - `documentUuid` string, nullable — The document UUID generated by Doc V SDK.
  - `docVTransactionToken` string, nullable — The DocVTransaction token generated by Doc V SDK.
  - `eventSource` string, nullable — The event source for the request.
  - `apiVersion` string, nullable — THe APi Version for the request.

## Response `202`

Accepted

- CreateIDVResponse — Represents the response returned after submitting identification verification information. Contains KYC state data.
  - `kycGate` CreateIdv — Represents the response object for an IDV (Identity Verification) operation. Contains the KYC (Know Your Customer) state data, including OFAC screening status, overall KYC status, and any pending KYC gates. Used to communicate the current verification and compliance state for a user after an IDV request.
    - `kycStateData` KycStateData — Represents the Know Your Customer (KYC) state data for a user. Contains information about OFAC (Office of Foreign Assets Control) screening status, overall KYC status, and any pending KYC gates. Used to track regulatory compliance and the current state of user verification during onboarding or account management.
      - `ofacStatus` string, nullable — The OFAC (Office of Foreign Assets Control) screening status for the user. Typical values: "Passed", "Failed", "Pending", or other business-specific status indicators.
      - `kycStatus` string, nullable — The overall KYC (Know Your Customer) status for the user. Typical values: "Verified", "Pending", "Failed", or other business-specific status indicators.
      - `kycPendingGate` string, nullable — The name or code of any pending KYC gate or step that must be completed for full verification. Example: "DocumentVerification", "AddressCheck", or null if no gates are pending.
  - `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.dev/greendot/apis/baas-apis.md) · [All operations](https://skmtc.dev/greendot/apis/baas-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greendot/baas-apis/revisions/666553766b78/schema)