---
title: "Fetch employment history from UAN"
method: POST
path: "/verify/employment_history"
tags: ["Employment"]
---

# Fetch employment history from UAN

`POST /verify/employment_history`

Fetches employment history (EPFO) associated with a UAN number. Requires authenticated request and delegates to the verification service with verification_type="employment_history".

## Request body

- EmploymentHistoryRequest
  - `uan_number` string, required — UAN number to fetch employment history for

## Response `200`

Employment history retrieved

- EmploymentHistoryResponse
  - `status` string — success / failed
  - `data` object
    - `message` string
    - `employment_records` EmploymentRecord[]
      - `employer_name` string
      - `designation` string
      - `start_date` string, date
      - `end_date` string, date, nullable
      - `contribution_months` integer
  - `chargeble` string — Whether the call is billable ('true'|'false')
  - `user_consent` string — Whether user consent is present ('true'|'false')

## Other responses

- `400` — Invalid request (missing uan_number)
- `401` — Unauthorized - Invalid or missing API key / client id
- `500` — Internal server error

---

[API](https://skmtc.dev/idto/apis/verification-api.md) · [All operations](https://skmtc.dev/idto/apis/verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idto/verification-api/revisions/e3d57dab8db4/schema)