POST /verifications/consent

POST /verifications/consent: retrieve the exact confirmation wording for a verification product before submitting.

Request the exact consent confirmation wording for a product and identity fields before you submit a verification. Present the returned text to the data subject for genuine confirmation. Changed identity details or wording require a fresh confirmation.

POST https://masterid.me/api/public/v1/verifications/consent

Authentication

X-API-Key · string · required

Your workspace API key.

X-API-Secret · string · required

Your workspace API secret.

Content-Type · string · required

Must be application/json.

Request body

product · string · required

Product code from GET /catalog. Example: tin, nin, phone.

fields · object · required

Identity fields for the verification, matching the product requirements in the catalog. Use exact selection values and date fields in YYYY-MM-DD format.

Response fields

id · string · required

API request ID.

data · object

Show properties

consentText · string · required

The exact confirmation wording for your account and subject. Present this text for genuine confirmation.

Status codes

Status	Meaning
200	OK. Consent text returned.
400	Invalid input, consent or idempotency header.
401	Missing, invalid or revoked credentials.
403	Suspended account.
429	API request limit reached. Check Retry-After.
500/503	Temporary processing error or unavailability.

Present consentText to the user for genuine confirmation. Do not silently accept it.

cURL

curl -X POST "https://masterid.me/api/public/v1/verifications/consent" \
  -H "X-API-Key: $MASTERID_API_KEY" \
  -H "X-API-Secret: $MASTERID_API_SECRET" \
  -H "Content-Type: application/json" \
  --data '{
    "product": "tin",
    "fields": {
      "tin": "<APPROVED_TIN>"
    }
  }'

200

{
  "id": "<REQUEST_ID>",
  "data": {
    "consentText": "<CONFIRMATION_WORDING_FOR_YOUR_ACCOUNT_AND_SUBJECT>"
  }
}