Quickstart

Make your first real StampMitra API call in about 5 minutes: sign up for a sandbox account, grab your API key, and verify a PAN.

1. 1. Create a sandbox account

   Sign up with your email, mobile number, and a password. No credit card or manual approval — this creates a SANDBOX organization and returns your first sk_test_ API key immediately.

2. 2. Save your API key

   The raw key is shown exactly once in the signup response. Every request after that authenticates with either header:

   Authorization: Bearer sk_test_xxxxxxxxxxxx
   # or
   x-api-key: sk_test_xxxxxxxxxxxx

3. 3. Make your first call: verify a PAN

   Verify a PAN in real time.

   curl -X POST "https://api.stampmitra.in/v1/verify/pan" \
     -H "Authorization: Bearer sk_test_xxxxxxxxxxxx" \
     -H "Content-Type: application/json" \
     -d '{"pan":"ABCDE1234F","name":"Ravi Kumar"}'

4. 4. Read the response

   A successful call returns a normalized result like:

   {
     "requestId": "vr_9f3a1c2b8e4d4a5f",
     "status": "SUCCESS",
     "verified": true,
     "source": "GOVERNMENT_DATABASE",
     "data": {
       "pan": "ABCDE1234F",
       "panStatus": "VALID",
       "fullName": "RAVI KUMAR",
       "nameMatch": true,
       "nameMatchScore": 0.98,
       "aadhaarSeedingStatus": "LINKED",
       "panType": "Individual",
       "lastUpdatedAt": "2026-08-12T00:00:00.000Z"
     },
     "meta": {
       "organizationId": "org_5f2c1a9b3d7e4f6a",
       "environment": "SANDBOX",
       "billedEvent": "pan.verify",
       "completedAt": "2026-09-25T10:15:32.481Z"
     }
   }