> ## Documentation Index
> Fetch the complete documentation index at: https://docs.masterid.co.ug/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```text theme={null}
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](https://docs.masterid.co.ug/api-reference/catalog/get-catalog.md). 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`

**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. |

> [!WARNING]
>
> Present `consentText` to the user for genuine confirmation. Do not silently accept it.

```bash cURL theme={null}
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>"
    }
  }'
```

```javascript Node.js theme={null}
const response = await fetch(
  "https://masterid.me/api/public/v1/verifications/consent",
  {
    method: "POST",
    headers: {
      "X-API-Key": process.env.MASTERID_API_KEY,
      "X-API-Secret": process.env.MASTERID_API_SECRET,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      product: "tin",
      fields: { tin: "<APPROVED_TIN>" },
    }),
  }
);
const body = await response.json();
console.log(body.data.consentText);
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://masterid.me/api/public/v1/verifications/consent",
    headers={
        "X-API-Key": os.environ["MASTERID_API_KEY"],
        "X-API-Secret": os.environ["MASTERID_API_SECRET"],
        "Content-Type": "application/json",
    },
    json={"product": "tin", "fields": {"tin": "<APPROVED_TIN>"}},
)
print(r.json()["data"]["consentText"])
```

```json 200 theme={null}
{
  "id": "<REQUEST_ID>",
  "data": {
    "consentText": "<CONFIRMATION_WORDING_FOR_YOUR_ACCOUNT_AND_SUBJECT>"
  }
}
```


## Related topics

- [Run a verification](https://docs.masterid.co.ug/guides/verifications.md)
- [Products and fields](https://docs.masterid.co.ug/products.md)
- [API Overview](https://docs.masterid.co.ug/api-reference/overview.md)
- [Go-live checklist](https://docs.masterid.co.ug/guides/go-live-checklist.md)
- [Errors](https://docs.masterid.co.ug/concepts/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.