Skip to main content
POST
Confirm a verification with the code the customer received

Authorizations

Authorization
string
header
default:BASIC <Meld API Key>
required

Headers

Meld-Version
string

Dated API version to use for this request, e.g. 2026-02-03.

Example:

"2026-02-03"

Authorization
string

Path Parameters

customerId
string
required

Customer id

verificationId
string
required

Verification id

Body

application/json

Request to confirm a verification with the code the customer received

code
string
required

The one-time code the customer received

Minimum string length: 1

Response

Confirm outcome is returned

Outcome of a verification confirm attempt

attemptsRemaining
integer<int32>

Confirm attempts remaining before the contact is locked out; only for FAILED

lineType
string

Phone line type when known (e.g. mobile); only for VERIFIED

status
enum<string>

Outcome status

Available options:
VERIFIED,
FAILED
verificationId
string

Verification id

verifiedAt
string

When the contact was verified (ISO-8601); only for VERIFIED