verification

Verify a contact against the MCA record

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.

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

Request body

dinstring required

8-digit DIN of the director. Provide din or pan.

panstring

PAN of the director (alternative to din).

mobilestring

The mobile number you hold. Matched on the last 10 digits.

emailstring

The email you hold. Matched case-insensitively.

Example request

{
  "din": "10934204",
  "pan": "DYTPS2790R",
  "mobile": "+91 98765 43210",
  "email": "asha.rao@example.com"
}

Response

Success.

transaction_idstring
checkstring
subject_type'din' | 'pan'
contact_on_recordboolean

Whether MCA held a verifiable contact for this person. When false, nothing was charged.

mobile_matchboolean nullable

true/false when checked; null when you did not supply that field, or MCA holds no value for it.

email_matchboolean nullable

true/false when checked; null when you did not supply that field, or MCA holds no value for it.

notestring

Present only when contact_on_record is false.

timestampinteger

Example response

{
  "check": "contact_verify"
}

Changes

No recorded changes to this operation across all 1 revision of this API.