Sign in

v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Employer Domain Verification w/o OTP

post/v2/kyc/identities/employment-verification/email

Headers

client_idstring required

ID/identifier that is provided by Decentro to a specific client and environment. Please note, this may change based on the environment you are on.

client_secretstring required

The confidential credential provided by Decentro that is associated with the client_id

Request body

reference_idstring required

Any unique ID assigned by you for this request

consentboolean required

true/false based on the consent given by the customer. Mandatory as per regulation.

purposestring required

The purpose of taking this consent from your customer. Mandatory as per regulation. (>20 characters)

emailstring required

The email of the individual whose employment details need to be verified

employer_namestring

An optional field denoting the name of the employer

Response

200

OR
OR
OR

Example response

{
  "decentroTxnId": "3D03FE7181C34E92ACDFD249A79ED618",
  "status": "SUCCESS",
  "responseCode": "S00000",
  "message": "The email address was verified successfully.",
  "data": {
    "domainRegistrationDate": "2018-01-10",
    "domainAgeInDays": 2576,
    "companyDetails": [
      {
        "company": "IDFC FIRST BANK LIMITED",
        "cin": "L65110TN2014PLC097792"
      }
    ],
    "account": {
      "username": "shabnum.zaman"
    }
  },
  "responseKey": "success_employment_email_verification"
}