Ration Card Verification

Identity & KYC

Confirm a ration card number and the household members listed on it.

Validate a state ration card against the public distribution system records and receive the card type, household head and member list, a widely accepted proof of address and family composition.

Endpoint

POST https://app.emver.io/api/sandbox/v1/ration-card-verification

Authorization: Bearer YOUR_API_KEY

Content-Type: application/json

Accept: application/json

Request parameters

Field	Type	Description
`ration_card_number` required	string	Ration card number
`state` required	string	State

Example request

cURL

curl -X POST https://app.emver.io/api/sandbox/v1/ration-card-verification \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "ration_card_number": "string",
    "state": "string"
}'

import requests

response = requests.post(
    "https://app.emver.io/api/sandbox/v1/ration-card-verification",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
    json={
        "ration_card_number": "string",
        "state": "string"
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()

const response = await fetch("https://app.emver.io/api/sandbox/v1/ration-card-verification", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
  },
  body: JSON.stringify({
      "ration_card_number": "string",
      "state": "string"
  }),
});

const data = await response.json();

$response = Http::withToken('YOUR_API_KEY')
    ->acceptJson()
    ->post('https://app.emver.io/api/sandbox/v1/ration-card-verification', {
        "ration_card_number": "string",
        "state": "string"
    });

$data = $response->json();

Replace YOUR_API_KEY and the placeholder values. Use the switch above to see production URLs.

Response

Structure · 200

{
  "status": INTEGER,
  "message": STRING,
  "data": {
    "card_type": STRING,
    "head_of_family": STRING,
    "district": STRING,
    "members": ARRAY,
    "status": STRING
  }
}

Example · 200

{
  "status": 200,
  "message": "string",
  "data": {
    "card_type": "string",
    "head_of_family": "string",
    "district": "string",
    "members": "string",
    "status": "string"
  }
}

Error · 4xx / 5xx

{
  "status": INTEGER,
  "message": STRING
}

See Errors & status codes for what each status means and which calls are billed.

About this API

Ration cards remain a primary identity and address document for large parts of the workforce. This API checks the number against the state PDS registry and returns the card category, the district and the members enrolled on it.

Typical uses

Gig and field workforce onboarding. Identity and address in one step for workers without other documents.
Micro-lending and insurance. Household verification for group products.

Questions

Is every state covered?: Coverage follows the states that expose PDS lookups; the response reports when a state is not supported.