---
title: "Beneficiary Status Enquiry"
method: POST
path: "/beneficiary-status"
---

# Beneficiary Status Enquiry

`POST /beneficiary-status`

API to request status of beneficiary action.

## Request body

- object
  - `entityId` string, required — Entity ID for your organization
  - `programId` string, required — Program id related to beneficiary activity
  - `custRefNo` string, required — Your alphanumeric internal reference for this beneficiary request. Response will be with this ID for status updates.

## Response `200`

Successful response

- object
  - `custRefNo` string — Your internal reference number for a specific beneficiary request sent in the original request.
  - `entityId` string — Entity ID for your organization
  - `programId` string — Program id related to beneficiary action
  - `info.status` string — Status of beneficiary action (see table below)
  - `info.message` string — Success or Error message
  - `info.bankCode` string — 4-character bank code (see example table below) where beneficiary is linked
  - `info.benCode` string — Beneficiary code
  - `info.benName` string — Beneficiary name
  - `info.benIFSC` string — IFS code for the beneficiary bank account
  - `info.benAcctNo` string — Beneficiary account number

---

[API](https://skmtc.net/jiopay/apis/jiopay-pg.md) · [All operations](https://skmtc.net/jiopay/apis/jiopay-pg/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jiopay/jiopay-pg/versions/55aa41b8482f/schema)