Request Method :: POST

Description: This API allows authorized systems to verify the authenticity and details of a ration card by providing key information such as aadhaar card number and ration card number.

Headers

---

Content-Type: application/JSON

header_secrets: Please refer to the steps for generating the header_secrets

pass_key:  To be shared during integration by ISU Team

Request Body Parameters

Parameters	Parameter description with validations and examples	Data type	Mandatory/Optional
consent	User consent, required to make the API request. e.g.- Y	String	Mandatory
aadhaarNumber	Aadhaar number linked to Ration card. e.g.- 123443211234 (Must have 12 digits)	string	Mandatory (Either Aadhaar Number or Ration card Number is required)
rationCardNumber	Ration Card Number. e.g.- 123443211276	String	Mandatory (Either Aadhaar Number or Ration card Number is required)

Sample Request Body

With Aadhaar Number:

---

{ "aadhaarNumber": "123443211234", "rationCardNumber": "", "consent": "Y" }

With Ration Card Number:

---

{ "aadhaarNumber": "", "rationCardNumber": "123443211276", "consent": "Y" }

Encrypted Sample Request Body

---

{ "RequestData": "P9mBZSNL5gxJySm7/eqpRwYq+lpORTxQ572GzI37m9oaseSpnZ9J2UWqUb65Qb58Bx+ITFeO4CWkl2zHbOSaxkCIqGHkQQ8FZKxFgY7JM8I=" }

Response Body Parameters

Parameters	Description	Data type
data	Fetched Data	Object
requestId	Request ID	string
result	Result of the operation.	object
address	Address (location of card holder)	string
allowdOnorc	whether an operation or verification is permitted on the Online Ration Card (ORC) system.	string/boolean
district	District (location of card holder)	String
dupUidStatus	Indicates whether the provided UID (Unique Identification number, e.g., Aadhaar) is detected as a duplicate in the system.	String
fpsId	Fair Price Shop ID	String
memberDetails	Details of the members	array
memberName	Name of the member	String
relationshipName	Relationship with card holder	string
uid	UID provided or not.	string
rcId	Ration Card ID.	String
schemeName	Scheme under which card holder is	string
state	Name of the State (location of card holder)	String
statusCode	Status Code	string
status	Verification Operation Status (SUCCESS/FAILED).	String
statusDesc	Status Description of the Operation. E.g.- "Successful ration_verifiction done"	String

Sample Response Body

---

SUCCESS:

{ "data": { "requestId": "950181b6-28c8-45ad-bdc4-c3d1ced72354", "result": { "address": "JIRAL 00", "allowdOnorc": "", "district": "DHENKANAL", "dupUidStatus": "No", "fpsId": "0901T057", "memberDetails": [ { "memberName": "BHABANISHANKAR NAYAK", "relationshipName": "SON", "uid": "Yes" }, { "memberName": "URMILA NAYAK", "relationshipName": "SELF", "uid": "Yes" }, { "memberName": "NIRANJAN NAYAK", "relationshipName": "HUSBAND", "uid": "Yes" } ], "rcId": "09011110264", "schemeName": "PHH", "state": "ORISSA" }, "statusCode": 101 }, "status": "SUCCESS", "statusCode": 0, "statusDesc": "Successful ration_verifiction done" }

 

FAILED:

Consent is missing:

{ "statuscode": "1", "status": "failed", "message": "Consent is mandatory", "data": {} }

Missing Aadhaar Number and Ration Card Number:

{ "statuscode": "1", "status": "failed", "message": "Either 'aadhaarNumber' or 'rationCardNumber' must be provided.", "data": {} }

Encrypted Sample Response Body

---

{ "ResponseData": "6WPyxnUErqH2aj8t9tCxs3D6EJh+uL+1xu3qmKSL/QUHsRLjBHfUyABdS/4jxkuHlcodjTlSd6qxFwPmnq8N/zxsGccp3nA1z5zfKVRsZUC1/knFV+2Un8vRn18u2ftaG/6XoCSdfnskvaMY16vyh9Y3rkvp2nOJRmzxY8u10yGw8UzKwfnEVSBsL4PoWHvaDua1rq1pcf16BhLniOEVjo0+j28ttx8nPN8LHgM2TuAF0pdaq12WBtf/0p415yTP+ura91nsltKWewupiRAudDrfTXUBxjEdM8SLskrgFaLVd6d5vYzMUIGtDH1R6IfInPFVa64F/iEr/93L7wIjEM0QnBJ497mlZTF5RQ+C6/TkKs6gDsPMUAiMiVApw7+IKt7uI2oejoZTFJ0H1/LmfD3Rf+AECN00cUpCV7L2wZId1vQcwXlvDAp2lHVb3OWkrA7J/VJm5NX78EPk8j+QsTYVAlXXbrNs1mlA5/Nc2ZyUidkX+gKEfRtPwreDH4TslyqBn0f1z4KmyeO4BasqGx5PMcO89ZfFf+SZC8Fs9o9f2fQbig+T71LXNCHDwlNlM6PlCvPKldyeZXgzhF/WOydupvjLS9umTnkdICNoUTI3z/RAdmEMpq0Cfd+han4IxCM2uj4db72GliMx5E059Zbwa6TOpYIHVINfKKcIc0PWpODWSHZWpfZXwqEGxa1Qn2JPnPcYDaeAkeQ7da3/osUxE093wWKg/fCwiPo1hMCsDx52mfCa69oXlfX1aMUyMvINA1xcrVwz+ylybnJdIw==" }