PM Kisan Beneficiary

6 min

Introduction

The PM Kisan beneficiary API is a service from SIgnzy, that would help the user to get the list of the PM Kisan scheme beneficiaries, of a given village of a particular state at a time. As, the reader will see in the output below, this API will return a list of all the beneficiaries of the scheme against the name of village, subdistrict, district, state name provided. The output would be a list of all the people as given by the PM Kisan, website.

Input Description

curl --location 'https://api-staging.signzy.app/api/v3/pmkisan-beneficiary/fetch' \
--header 'Authorization: <AURTHORIZATION>' \
--header 'Content-Type: application/json' \
--data '{
    "state": "<STATE-NAME>",
    "district": "<DISTRICT-NAME>",
    "subDistrict": "<Sub-District-Name>",
    "village": "<Village-Name>"
}'

Input Description

Input Parameter	Description	Required
state	Name of the Indian State from where we we need data of PM kisan beneficiaries	Yes
district	District, under the state name provided in state field	Yes
subdistrict	Subdistrict, under the district name provided in district field	Yes
village	Village, under the subdistrict name provided in subdistrict field	Yes

Output

{
    "benificiaryData": [
        {
            "name": "<beneficiary name>",
            "sex": "<beneficiary gender>"
        },
        {
            "name": "<beneficiary name>",
            "sex": "<beneficiary gender>"
        },
        {
        ...
        },
        {
        ...
        },
        {
            "name": "<beneficiary name>",
            "sex": "<beneficiary gender>"
        }
    ],
     "regionCodes": {
        "state_id": "<state-id>",
        "district_id": "<district-id>",
        "sub_district_id": "<sub-district-id>",
        "village_id": "<village-id>"
    }

}

Output description

Output Parameter	Description	Data Type
benificiaryData	List of PM Kisan beneficiaries of the given parameters	List of Objects
name	name of PM kisan beneficiary	string
sex	gender of PM Kisan beneficiary	string
regionCodes	Contains IDs of specific state, district, subdistrict & village passed as input parameters	Object
state_id	ID of state passed in input	string
district_id	ID of district passed as input	string
sub_district_id	ID of subdistrict passed as input	string
village_id	ID of village passed as input	string

Status codes

Status Code	Message	Description
200	Success	Request is served successfully
400	Region details not found	The, region details are not available or not found
409	Upstream is down	The PM Kisan website was not working correctly
422	Unprocessable Entity	The inputs are invalid
503	Internal Exception	There is a internal error in the API