---
title: "Generate Contact Verifications"
method: POST
path: "/programs/{programCode}/contactVerifications"
tags: ["ContactVerification"]
---

# Generate Contact Verifications

`POST /programs/{programCode}/contactVerifications`

Generates contact verifications for a given program and request. Returns the generated contact verification identifier.

## Path parameters

- `programCode` string, required

## Headers

- `X-GD-RequestId` string, required

## Request body

- GenerateVerificationsRequest — Represents a request to generate verification events for a specified account and contact. Contains all necessary information to initiate verification, including account details, contact information, event type, and product context. Used to trigger verification workflows such as email, SMS, or other communication types for identity or product validation.
  - `accountIdentifier` string, nullable — The unique identifier for the account to be verified.
  - `verificationEventType` string, nullable — The type of verification event to generate (e.g., registration, password reset).
  - `contactType` string, nullable — The type of contact to use for verification (e.g., email, phone).
  - `communicationType` string, nullable — The communication channel to use for verification (e.g., SMS, email).
  - `contactHandle` string, nullable — The handle or address of the contact (e.g., email address, phone number).
  - `firstName` string, nullable — The first name of the contact person.
  - `lastName` string, nullable — The last name of the contact person.
  - `productCode` string, nullable — The product code associated with the verification request.
  - `retailCardIdentifier` string, nullable — The retail card identifier, used as a legacy NEC temporary card reference number.

## Response `201`

Created

- GenerateVerificationsResponse — Represents the response for generating contact verifications. Contains the identifier for the contact verification and standard response metadata.
  - `contactVerificationIdentifier` string, nullable — Gets or sets the unique identifier for the contact verification. Used to track and reference the verification process for a contact.
  - `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)