---
title: "Send the screening link to the applicant"
method: POST
path: "/v2/screening/send"
tags: ["Screening V2"]
---

# Send the screening link to the applicant

`POST /v2/screening/send`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v2/screening/send`
- Auth: API key in header `Authorization`

Send the screening link

## Request body

- V2SendScreeningRequest
  - `flowId` string
  - `email` string
  - `phone` string
  - `firstName` string
  - `lastName` string
  - `metadata` object
  - `options` V2ScreeningRequestOptions
    - `emailDisabled` boolean
    - `smsDisabled` boolean
  - `payer` 'PAYER_UNSPECIFIED' | 'PAYER_SELF' | 'PAYER_APPLICANT'

## Response `200`

A successful response.

- V2SendScreeningResponse
  - `message` string
  - `userId` string
  - `screeningId` string
  - `screeningLink` string

## Other responses

- `default`: An unexpected error response.

## Changes

- **2025-06-03** `d073d48df6b1`: 3 info
  - api tag `Screening V2` added
  - api tag `Screening` removed
  - added the new optional request property `metadata`
- **2025-04-07** `b8251b9b3893`: 5 info
  - api tag `Screening` added
  - api tag `ScreeningV2` removed
  - added the new optional request property `options`
  - added the optional property `screeningId` to the response with the `200` status
  - …1 more
- **2025-02-04** `cdffd1dc8f9f`: 2 info
  - api tag `ScreeningV2` added
  - api tag `Screening` removed
- **2025-02-03** `dd2313bb2283`: 1 info
  - endpoint added
- **2025-02-02** `67b7e6175415`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/getcove/apis/proto-screening-v2-screening-proto/changes/v2/screening/send/post.md)

---

[API](https://skmtc.dev/getcove/apis/proto-screening-v2-screening-proto.md) - [All operations](https://skmtc.dev/getcove/apis/proto-screening-v2-screening-proto/llms.txt) - [OpenAPI document](https://skmtc.dev/getcove/apis/proto-screening-v2-screening-proto/revisions/9d9f9d9f0188?raw)