---
title: "Employment Verification"
method: POST
path: "/synchronous/hyperstream-executor#employment-verification"
---

# Employment Verification

`POST /synchronous/hyperstream-executor#employment-verification`

## Headers

- `client_id` string, required
- `client_secret` string, required

## Request body

- object
  - `reference_id` string, required — Any unique ID assigned by you for this request
  - `hyperstream` string, required — The name of the HyperStream
  - `initial_input` object, required
    - `email` string, required — The email of the individual whose employment details need to be verified
    - `employer_name` string — An optional field denoting the name of the employer
  - `consent` boolean, required — true/false based on the consent given by the customer. Mandatory as per regulation.
  - `consent_purpose` string, required — The purpose of taking this consent from your customer. Mandatory as per regulation. (>20 characters)

## Response `200`

200

- union
  - object
    - `hyperstream_txn_id` string
    - `status` string
    - `http_status_code` integer
    - `response_key` string
    - `data` object
      - `EMAIL_VERIFICATION` object
        - `domainRegistrationDate` string
        - `domainAgeInDays` integer
        - `isDisposable` boolean
        - `isPublic` boolean
        - `companyDetails` object[]
          - `company` string
          - `cin` string
          - `reportedContactDomain` string
          - `inputDomainStringMatch` integer
          - `inputDomainPhoneticMatch` integer
        - `account` object
          - `username` string
          - `isGibberish` boolean
      - `BULK_CIN_VALIDATE` object
        - `results` object[]
          - `companyData` object
            - `cIN` string
            - `company` string
            - `companyType` string
            - `companyOrigin` string
            - `registrationNumber` string
            - `dateOfIncorporation` string
            - `emailAddress` string
            - `whetherListedOrNot` string
            - `companyCategory` string
            - `companySubcategory` string
            - `classOfCompany` string
            - `authorisedCapital` string
            - `paidUpCapital` string
            - `numberOfMembers` string
            - `dateOfLastAGM` string
            - `strikeOffAmalgamatedTransferredDate` string
            - `statusUnderCIRP` string
            - `numberOfPartners` string
            - `numberOfDesignatedPartners` string
            - `previousFirmCompanyDetails` string
            - `totalObligationOfContribution` string
            - `mainDivision` string
            - `mainDivisionDescription` string
            - `statementDate` string
            - `bSDefaulter2Yrs` string
            - `bSDefaulter3Yrs` string
            - `aRDefaulter2Yrs` string
            - `aRDefaulter3Yrs` string
            - `suspendedAtStockExchange` string
            - `rocName` string
            - `shareCapitalFlag` string
            - `maximumNumberOfMembers` string
            - `subscribedCapital` string
            - `rdName` string
            - `rdRegion` string
            - `balanceSheetDate` string
            - `inc22Aflag` string
            - `establishmentDate` string
            - `registeredAddress` string
            - `companyStatus` string
          - `directorData` object[]
            - `dIN` string
            - `pAN` string
            - `dateOfAppointment` string
            - `directorDisqualified` string
            - `firstName` string
            - `middleName` string
            - `lastName` string
    - `message` string
    - `reference_id` string
  - object
    - `hyperstream_txn_id` string
    - `status` string
    - `http_status_code` integer
    - `response_key` string
    - `data` object
      - `EMAIL_VERIFICATION` object
        - `domainRegistrationDate` string
        - `domainAgeInDays` integer
        - `isDisposable` boolean
        - `isPublic` boolean
        - `companyDetails` object[]
          - `company` string
          - `cin` string
          - `reportedContactDomain` string
          - `inputDomainStringMatch` integer
          - `inputDomainPhoneticMatch` integer
        - `account` object
          - `username` string
          - `isGibberish` boolean
      - `BULK_CIN_VALIDATE` object
        - `results` object[]
          - `companyData` object
            - `cIN` string
            - `company` string
            - `companyType` string
            - `companyOrigin` string
            - `registrationNumber` string
            - `dateOfIncorporation` string
            - `emailAddress` string
            - `whetherListedOrNot` string
            - `companyCategory` string
            - `companySubcategory` string
            - `classOfCompany` string
            - `authorisedCapital` string
            - `paidUpCapital` string
            - `numberOfMembers` string
            - `dateOfLastAGM` string
            - `strikeOffAmalgamatedTransferredDate` string
            - `statusUnderCIRP` string
            - `numberOfPartners` string
            - `numberOfDesignatedPartners` string
            - `previousFirmCompanyDetails` string
            - `totalObligationOfContribution` string
            - `mainDivision` string
            - `mainDivisionDescription` string
            - `statementDate` string
            - `bSDefaulter2Yrs` string
            - `bSDefaulter3Yrs` string
            - `aRDefaulter2Yrs` string
            - `aRDefaulter3Yrs` string
            - `suspendedAtStockExchange` string
            - `rocName` string
            - `shareCapitalFlag` string
            - `maximumNumberOfMembers` string
            - `subscribedCapital` string
            - `rdName` string
            - `rdRegion` string
            - `balanceSheetDate` string
            - `inc22Aflag` string
            - `establishmentDate` string
            - `registeredAddress` string
            - `companyStatus` string
          - `directorData` object[]
            - `dIN` string
            - `pAN` string
            - `dateOfAppointment` string
            - `directorDisqualified` string
            - `firstName` string
            - `middleName` string
            - `lastName` string
          - `sourceDb` boolean
    - `message` string
    - `reference_id` string
  - object
    - `hyperstream_txn_id` string
    - `status` string
    - `http_status_code` integer
    - `response_key` string
    - `data` object
      - `EMAIL_VERIFICATION` object
        - `domainRegistrationDate` string
        - `domainAgeInDays` integer
        - `isDisposable` boolean
        - `isPublic` boolean
        - `companyDetails` object[]
          - `company` string
          - `cin` string
          - `reportedContactDomain` string
          - `inputDomainStringMatch` integer
          - `inputDomainPhoneticMatch` integer
        - `account` object
          - `username` string
          - `isGibberish` boolean
      - `BULK_CIN_VALIDATE` object
        - `results` object[]
          - `companyData` object
            - `cIN` string
            - `company` string
            - `companyType` string
            - `companyOrigin` string
            - `registrationNumber` string
            - `dateOfIncorporation` string
            - `emailAddress` string
            - `whetherListedOrNot` string
            - `companyCategory` string
            - `companySubcategory` string
            - `classOfCompany` string
            - `authorisedCapital` string
            - `paidUpCapital` string
            - `numberOfMembers` string
            - `dateOfLastAGM` string
            - `strikeOffAmalgamatedTransferredDate` string
            - `statusUnderCIRP` string
            - `numberOfPartners` string
            - `numberOfDesignatedPartners` string
            - `previousFirmCompanyDetails` string
            - `totalObligationOfContribution` string
            - `mainDivision` string
            - `mainDivisionDescription` string
            - `statementDate` string
            - `bSDefaulter2Yrs` string
            - `bSDefaulter3Yrs` string
            - `aRDefaulter2Yrs` string
            - `aRDefaulter3Yrs` string
            - `suspendedAtStockExchange` string
            - `rocName` string
            - `shareCapitalFlag` string
            - `maximumNumberOfMembers` string
            - `subscribedCapital` string
            - `rdName` string
            - `rdRegion` string
            - `balanceSheetDate` string
            - `inc22Aflag` string
            - `establishmentDate` string
            - `registeredAddress` string
            - `companyStatus` string
          - `directorData` object[]
            - `dIN` string
            - `pAN` string
            - `dateOfAppointment` string
            - `directorDisqualified` string
            - `firstName` string
            - `middleName` string
            - `lastName` string
          - `sourceDb` boolean
    - `message` string
    - `reference_id` string

## Other responses

- `400` — 400
- `422` — 422
- `500` — 500
- `2XX` — 2XX

---

[API](https://skmtc.dev/decentro/apis/decentro-staging.md) · [All operations](https://skmtc.dev/decentro/apis/decentro-staging/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decentro/decentro-staging/revisions/f1a86ce4638c/schema)