---
title: "Verify a contact against the MCA record"
method: POST
path: "/kyc/verify/contact"
tags: ["verification"]
---

# Verify a contact against the MCA record

`POST /kyc/verify/contact`

## Request

- Base URL: `https://api.qorpiq.com`
- URL: `https://api.qorpiq.com/kyc/verify/contact`
- Auth: API key in header `x-api-key`

Confirm-don't-reveal contact check. Supply a director by DIN or PAN and the mobile and/or email you already hold; the response returns only match verdicts (mobile_match, email_match) and never the value MCA holds. When MCA has no verifiable contact for the person, contact_on_record is false and the call is not charged. Built for onboarding and fraud checks where you confirm details a person gave you, under your lawful-use terms.

## Request body

- ContactVerifyRequest
  - `din` string, required: 8-digit DIN of the director. Provide din or pan.
  - `pan` string: PAN of the director (alternative to din).
  - `mobile` string: The mobile number you hold. Matched on the last 10 digits.
  - `email` string: The email you hold. Matched case-insensitively.

## Response `200`

Success.

- ContactVerifyResponse
  - `transaction_id` string
  - `check` string
  - `subject_type` 'din' | 'pan'
  - `contact_on_record` boolean: Whether MCA held a verifiable contact for this person. When false, nothing was charged.
  - `mobile_match` boolean, nullable: true/false when checked; null when you did not supply that field, or MCA holds no value for it.
  - `email_match` boolean, nullable: true/false when checked; null when you did not supply that field, or MCA holds no value for it.
  - `note` string: Present only when contact_on_record is false.
  - `timestamp` integer

## Other responses

- `400`: Invalid DIN/PAN, or neither mobile nor email supplied.
- `401`: Missing or invalid x-api-key.
- `402`: Balance too low for this call. Add money to your QorpIQ balance to continue (reason credit_balance_exhausted is kept for compatibility).
- `503`: The MCA data source is temporarily unavailable. Not charged.

---

[API](https://skmtc.dev/qorpiq/apis/qorpiq-kyc-kyb-api.md) · [All operations](https://skmtc.dev/qorpiq/apis/qorpiq-kyc-kyb-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qorpiq/apis/qorpiq-kyc-kyb-api/revisions/5a9c792b6c06?raw)