---
title: "Generate DocV Document Request – Returns a DocVTransaction Token for Socure DocV SDK initialization."
method: POST
path: "/programs/{programCode}/accounts/{accountIdentifier}/users/{userIdentifier}/socureDocumentRequest"
tags: ["Kyc"]
---

# Generate DocV Document Request – Returns a DocVTransaction Token for Socure DocV SDK initialization.

`POST /programs/{programCode}/accounts/{accountIdentifier}/users/{userIdentifier}/socureDocumentRequest`

Returns a DocVTransaction Token for Socure DocV SDK initialization and an optional upload URL for user identity documents.

## Path parameters

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

## Headers

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

## Response `202`

Accepted

- GenerateDocumentResponse — Represents the response returned after generating a DocV document request for Socure DocV SDK initialization. Contains the reference ID, document upload URL, and DocVTransaction token required for document upload and verification. Used to provide partners with the necessary information to upload user identity documents and initialize the verification process.
  - `referenceId` string, nullable — The unique reference identifier for the document request. Used to track and correlate the document upload and verification process.
  - `documentUploadUrl` string, nullable — The URL to which the user’s identity document should be uploaded. Used by partners to submit document images for verification.
  - `docVTransactionToken` string, nullable — The DocVTransaction token generated for the document verification session. Used to initialize the Socure DocV SDK and link the uploaded document to the verification flow.
  - `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/revisions/666553766b78/schema)