---
title: "Fetch PF employee passbook"
method: POST
path: "/verify/pf_employee_passbook"
tags: ["UAN Verification"]
---

# Fetch PF employee passbook

`POST /verify/pf_employee_passbook`

Retrieves EPFO employee, establishment, passbook, and overall PF balance details using a 12-digit UAN. Overall PF balance retrieval is enabled by default. Requires authentication and delegates to the verification service with verification_type="pf_employee_passbook".

## Request body

- PFEmployeePassbookRequest — UAN required to fetch the employee passbook and overall PF balance.
  - `uan_number` string, required — 12-digit UAN number to fetch the employee passbook for

## Response `200`

PF employee passbook retrieved successfully

- PFEmployeePassbookResponse
  - `status` 'success' | 'failed'
  - `message` string
  - `data` object
    - `employee_details` object — Employee identity and UAN details returned by EPFO
    - `est_details` PFEmployeeEstablishmentDetails[]
      - `est_name` string
      - `member_id` string
      - `office` string
      - `doj_epf` string
      - `doc_epf` string
      - `doc_eps` string
      - `passbook_status` string
      - `passbook` PFEmployeePassbookTransaction[]
        - `tr_date_my` string
        - `approved_on` string
        - `cr_ee_share` string
        - `cr_er_share` string
        - `cr_pen_bal` string
        - `db_cr_flag` string
        - `particular` string
        - `wage_month` string
        - `tr_approved` string
    - `overall_pf_balance` object — Aggregate PF and pension balances when available
    - `input_data` object — Lookup fields acknowledged by the passbook service
  - `error_code` string, nullable
  - `chargeble` string — Whether the call is billable ('true'|'false')
  - `user_consent` string — Whether user consent is present ('true'|'false')

## Other responses

- `400` — Invalid request - UAN/PAN missing or malformed, mobile invalid, or provider rejected the parameters
- `401` — Unauthorized - Invalid or missing API key / client id
- `404` — No passbook data found for the supplied details
- `500` — Internal server error
- `502` — Invalid, empty, or unavailable response from the passbook service
- `503` — EPFO source is busy or temporarily unavailable

---

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