Ration Card API

Ration V2 API

Verify a ration card and get household member details.

Get API key Talk to sales

REST + JSONOne API keyPay per callHTTPS secured

POST/v1/ration-v2ready

Request

Response{  "error": false,  "status": "SUCCESS",  "data": {    "card_status_and_type": "…",    "household_member_details": "…"  }}

Illustrative example. Exact parameters are listed in your dashboard docs.

How it works

What you send and what you get back

Verify ration cards and household members for welfare, address-proof and identity use cases.

You send

Ration card number
State (where required)

You get back

Card status and type
Household member details

Why Shadoweye

Built for production from day one

Real-time results

Responses come back in milliseconds, so the check fits inline in your signup or approval flow.

Clean, consistent JSON

Every Shadoweye API returns the same response envelope. Parse it once and reuse it everywhere.

One key for every API

Use the same API key for the Ration V2 API and every other API in the catalogue. No extra contracts.

Pay per call

Calls are charged from your prepaid wallet. No monthly fee and no minimum commitment.

Secure by default

All traffic runs over HTTPS and every request is authenticated with your secret key.

Full audit trail

Every call and deduction is recorded in your dashboard ledger for reconciliation and audits.

Use cases

Where teams use the Ration V2 API

Address proof

Use ration cards as supporting proof of address.

Welfare delivery

Confirm beneficiary eligibility.

Household KYC

Verify family members linked to a card.

Rural onboarding

Support customers without other documents.

Get started

Go live in four steps

Create your account

Add funds

Top up your prepaid wallet securely with UPI, card or net banking.

Test it live

Try the Ration V2 API with real data in the Live Tester before you write code.

Call the API

Send a POST request with your key in the X-Shadoweye-Api-Key header and use the JSON response.

FAQ

Frequently asked questions

What is the Ration V2 API?

Verify a ration card and get household member details. It is part of the Shadoweye Ration Card API family and is available through a single REST API key.

What do I need to send to the Ration V2 API?

Typical inputs are: Ration card number; State (where required). The exact parameters for this API are listed in your dashboard documentation.

What does the Ration V2 API return?

You receive a JSON response that typically includes: Card status and type; Household member details.

How much does the Ration V2 API cost?

Calls are charged per request from your prepaid Shadoweye wallet at the rate shown in your dashboard. There are no monthly fees or minimum commitments.

How do I get started?

Create a free account, add funds to your wallet, copy your API key and test the API in the Live Tester. Most teams go live the same day.

Is my data secure?

All requests use HTTPS, are authenticated with your secret API key and are recorded in your audit ledger. Only send personal data you are permitted to process, with the customer's consent where required.

Related Ration Card API

View all

Ration Card Verification

Verify a ration card number and get card type and status.

Telangana Rice Card

Verify a Telangana ration card with Aadhaar OTP and get a print-ready rice card PDF with front and back images.