post https://in.staging.decentro.tech/v2/kyc/identities/employment-verification/email
Important Note
Please use only Staging Credentials on each API Reference page to test the APIs directly from our Documentation.
API Endpoints
| Environment | Host |
|---|---|
| Staging | in.staging.decentro.tech |
| Production | in.decentro.tech |
Response Parameters
| Key | Description | Datatype |
|---|---|---|
| decentroTxnId | Unique identifier for the transaction | String |
| status | Status of the verification process | String |
| responseCode | Response code indicating the result of the verification | String |
| message | Message providing additional information about the verification process | String |
| data | An object containing detailed information about the email address and associated account | Object |
| data.isDisposable | Indicates whether the email address is disposable (temporary) or not | Boolean |
| data.domainAge | Indicates the age of the domain | String |
| data.domainRegistrationDate | Indicates the date of the registration of the email domain in YYYY-MM-DD format | String |
| data.companyDetails | Object containing details about the company associated with the email address | Object |
| data.companyDetails.* (various keys under companyDetails) | Various details about the company such as registration information, address, and financial details | String |
| data.account | An object containing information about the associated account | Object |
| data.account.username | Username associated with the account | String |
| data.account.isGibberish | Indicates whether the username appears to be random or nonsensical | Boolean |
| responseKey | Key indicating the type of response | String |
Response Keys and Scenarios
The following list contains the various response keys along with 1 sample response JSON corresponding to each of them.
success_employment_email_verification-> HTTP 200 Success (A private email was found)
{
"decentroTxnId": "D26E2126BA714CABB34C46A593C0B1A3",
"status": "SUCCESS",
"responseCode": "S00000",
"message": "The email address was verified successfully.",
"data": {
"domainRegistrationDate": "2019-12-19",
"domainAgeInDays": 1812,
"isDisposable": false,
"isPublic": false,
"companyDetails": {
"cIN": "U74999HR2020PTC086125",
"company": "DECENTRO TECH PRIVATE LIMITED",
"companyType": "Company",
"companyOrigin": "Indian",
"registrationNumber": "086125",
"dateOfIncorporation": "04/23/2020",
"emailAddress": "[email protected]",
"whetherListedOrNot": "N",
"companyCategory": "Company limited by shares",
"companySubcategory": "Non-government company",
"classOfCompany": "Private",
"authorisedCapital": "2000000",
"paidUpCapital": "1648400",
"numberOfMembers": "",
"dateOfLastAGM": "09/30/2024",
"strikeOffAmalgamatedTransferredDate": "",
"llpStatus": "Active",
"statusUnderCIRP": "",
"numberOfPartners": "",
"numberOfDesignatedPartners": "",
"previousFirmCompanyDetails": "",
"totalObligationOfContribution": "0",
"mainDivision": "74",
"mainDivisionDescription": "REAL ESTATE,RENTING AND BUSINESS ACTIVITIES",
"statementDate": "",
"bSDefaulter2Yrs": "",
"bSDefaulter3Yrs": "",
"aRDefaulter2Yrs": "",
"aRDefaulter3Yrs": "",
"suspendedAtStockExchange": "",
"rocName": "ROC Delhi",
"shareCapitalFlag": "Y",
"maximumNumberOfMembers": "",
"subscribedCapital": "1648400",
"rdName": "RD Noida",
"rdRegion": "Northern Region",
"balanceSheetDate": "03/31/2024",
"inc22Aflag": ""
},
"account": {
"username": "sample",
"isGibberish": false
}
},
"responseKey": "success_employment_email_verification"
}
success_public_email_found-> HTTP 200 Success (A public email was found)
{
"decentroTxnId": "DFDD9350B1724B09A9B82E8F0B670CB1",
"status": "FAILURE",
"responseCode": "S00000",
"message": "The email address was verified successfully.",
"data": {
"isDisposable": false,
"isPublic": true,
"account": {
"username": "sample",
"isGibberish": false
}
},
"responseKey": "success_public_email_found"
}
error_invalid_email-> HTTP 400 Bad Request (For an invalid email)
{
"decentroTxnId": "2E25C80903DF437289F210CF04D67529",
"status": "FAILURE",
"responseCode": "E00009",
"message": "Invalid email. Please pass a valid email.",
"responseKey": "error_invalid_email"
}
error_duplicate_reference_id-> HTTP 400 Bad Request (For duplicate reference ID)
{
"decentroTxnId": "B30A2E575F4B463C81F04A0DB549B122",
"status": "FAILURE",
"responseCode": "E00019",
"message": "Duplicate Request Reference ID",
"responseKey": "error_duplicate_reference_id"
}