verification

Directorship check (background verification)

Given a PAN or DIN, every company the individual is a director/partner of, plus disqualification. For BGV / conflict-of-interest checks.

post/kyc/verify/director-affiliations

Request

  • Base URL: https://api.qorpiq.com
  • URL: https://api.qorpiq.com/kyc/verify/director-affiliations
  • Auth: API key in header x-api-key

Request body

realtimeboolean

Read the record live from MCA instead of our saved copy. Default false: a saved copy that covers this check answers first, and MCA is read live only when we hold no sufficient record. Live reads are available to accounts enabled for them; if a live read cannot run, the saved copy answers and the response says so.

panstring
dinstring

Example request

{
  "pan": "AJGPK6414M"
}

Response

Success.

transaction_idstring uuid

Unique id for this request, echoed in the X-Transaction-Id header.

checkstring
has_dinboolean

false = the individual holds no directorships on record.

dinstring
namestring
din_statusstring
is_disqualifiedboolean
disqualificationobject nullable
directorships_source'mca' | 'saved_copy' | 'unavailable'

mca = company list read live from MCA. saved_copy = from QorpIQ's director register (the default when we hold one; send realtime for a live read). unavailable = no company list could be read; DIN status is still live, directorships is null and the call is not charged.

directorship_countinteger
active_directorship_countinteger
timestampinteger

Response time (epoch ms).

Example response

{
  "check": "director_affiliations"
}

Changes

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