---
title: "Employment Verification"
method: POST
path: "/v1/employments"
---

# Employment Verification

`POST /v1/employments`

## Request

- Base URL: `https://api.qoreid.com`
- URL: `https://api.qoreid.com/v1/employments`
- Auth: OAuth 2

Create employment verification

## Request body

- object
  - `customerReference` string, required: Customer reference
  - `employerName` string, required: Employer's name
  - `employerEmail` string, required: Employer's email address
  - `employerPhone` string, required: Employer's phone number
  - `startDate` string, date, required: Start of employment
  - `endDate` string, date, required: End of employment
  - `jobTitle` string, required: Job title
  - `currentlyEmployed` boolean, required: Employment status flag
  - `contactPersonName` string, required: Contact person's name
  - `applicant` object
    - `firstname` string, required: Applicant's first name
    - `lastname` string, required: Applicant's last name
    - `phone` string, required: Applicant's phone number
    - `dob` string, date: Applicant's date of birth
    - `idType` 'nin' | 'bvn' | 'drivers_license': Applicant's identification(bvn, nin or drivers_license)
    - `idNumber` string: Applicant's identification number

## Response `200`

200

- object
  - `id` integer
  - `customerReference` string
  - `applicant` object
    - `firstname` string
    - `middlename` string
    - `lastname` string
    - `gender` string
    - `phone` string
    - `dob` string
  - `status` object
    - `status` string
    - `subStatus` string
    - `state` string
  - `employment` object
    - `id` integer
    - `verificationTypeCode` string
    - `isAsset` boolean
    - `organisationId` integer
    - `requestedAt` string
    - `consentReference` string
    - `requestSource` string
    - `archived` boolean
    - `canContactPoc` boolean
    - `isVague` boolean
    - `customerReference` string
    - `paymentMethodCode` string
    - `employmentDetails` object
      - `currentlyEmployed` boolean
      - `endDate` string
      - `jobTitle` string
      - `startDate` string
    - `employerDetails` object
      - `contactPersonName` string
      - `email` string
      - `name` string
      - `phone` string
    - `price` integer
    - `updatedAt` string
    - `status` object
      - `status` string
      - `subStatus` string
      - `state` string

## Changes

- **2026-11-03** `fd968e79b743`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qoreid/apis/baseurl/changes/v1/employments/post.md)

---

[API](https://skmtc.dev/qoreid/apis/baseurl.md) - [All operations](https://skmtc.dev/qoreid/apis/baseurl/llms.txt) - [OpenAPI document](https://skmtc.dev/qoreid/apis/baseurl/revisions/fd968e79b743?raw)