Endpoint

POST /v1/verify/rc

POST/v1/verify/rcScope verification.rc.readप्रति सफल call ₹9 से शुरूलाइव

Vehicle RC को validate और verify करता है। API key पर verification.rc.read scope ज़रूरी है। सफल response के बाद इसे rc.verify के रूप में metered किया जाता है - usage तभी दर्ज होता है (और priced services के लिए fulfilment wallet तभी debit होता है) जब verification सफलतापूर्वक पूरा हो जाए। नीचे दिया गया response /v1/verify/rc से लौटने वाला असली shape है, जिसमें referenceId field भी शामिल है।

Request

Request के parameters

Request के parameters
Field	Type	विवरण
`Authorization`ज़रूरी	`header`	Bearer <api-key> (जैसे sandbox में sk_test_..., production में sk_live_...)। x-api-key header भी स्वीकार किया जाता है।
`vehicleNumber`ज़रूरी	`string`	Vehicle registration number।

उदाहरण

Call करके देखें

curl -X POST "https://api-b2b.stampmitra.in/v1/verify/rc" \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"vehicleNumber":"MH12AB1234"}'

Playground

Try करें

Sandbox API keyDashboard से sk_test_ key use करें। यह सिर्फ़ इस browser tab में रहती है और केवल API को भेजी जाती है।Request body (JSON)

Response

Response का उदाहरण

ResponseJSON

{
  "referenceId": "SMV-20260927-3D71Q9",
  "regNo": "MH12AB1234",
  "registrationStatus": "VALID",
  "ownerName": "RAHUL KUMAR",
  "ownerFatherName": "SURESH KUMAR",
  "vehicleClass": "LMV",
  "vehicleManufacturerName": "MARUTI SUZUKI",
  "model": "SWIFT",
  "vehicleColor": "WHITE",
  "chassis": "MA3ERLF1S00123456",
  "engine": "K12MN1234567",
  "registrationDate": "2019-05-14",
  "rcStatus": "ACTIVE",
  "rcExpiryDate": "2034-05-13",
  "insuranceUpto": "2025-05-13",
  "isCommercial": false
}

Response के fields
Field	Type
`referenceId`	`string`
`regNo`	`string`
`registrationStatus`	`string`
`ownerName`	`string`
`ownerFatherName`	`string`
`vehicleClass`	`string`
`vehicleManufacturerName`	`string`
`model`	`string`
`vehicleColor`	`string`
`chassis`	`string`
`engine`	`string`
`registrationDate`	`string`
`rcStatus`	`string`
`rcExpiryDate`	`string`
`insuranceUpto`	`string`
`isCommercial`	`boolean`

Errors

Error responses

401API key missing या invalid

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid API key.",
    "requestId": "a1b2c3d4-e5f6-4a1b-8c2d-9f0e1a2b3c4d"
  }
}

403Key valid है, पर ज़रूरी scope नहीं है

{
  "error": {
    "code": "FORBIDDEN",
    "message": "API key is valid but lacks the required scope for this endpoint.",
    "requestId": "a1b2c3d4-e5f6-4a1b-8c2d-9f0e1a2b3c4d"
  }
}

400Validation error

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "vehicleNumber must match the format MH12AB1234",
    "requestId": "a1b2c3d4-e5f6-4a1b-8c2d-9f0e1a2b3c4d"
  }
}

402Wallet balance अपर्याप्त

{
  "error": {
    "code": "PAYMENT_REQUIRED",
    "message": "Insufficient fulfilment wallet balance to cover this call.",
    "requestId": "a1b2c3d4-e5f6-4a1b-8c2d-9f0e1a2b3c4d"
  }
}

429Rate limit पार हो गई

{
  "error": {
    "code": "TOO_MANY_REQUESTS",
    "message": "Rate limit exceeded: 60 requests per 60 seconds for this endpoint.",
    "requestId": "a1b2c3d4-e5f6-4a1b-8c2d-9f0e1a2b3c4d"
  }
}

502Upstream verification service तक पहुँच नहीं हो पाई

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Unable to reach the order/customer service right now",
    "requestId": "5c1c1e9e-2f7b-4b7a-9b0e-0f1a2b3c4d5e"
  }
}

ध्यान दें

जानने लायक बातें

नोट

Input format पहले ही validate किया जाता है - गलत format वाला pan/gstin/आदि verification के लिए भेजे जाने के बजाय तुरंत 400 के साथ fail हो जाता है। referenceId (format SMV-YYYYMMDD-XXXXXXX) इस call के लिए StampMitra की अपनी transaction id है और हमेशा मौजूद रहती है, negative (valid: false / found: false) result में भी - positive और negative दोनों determinations पूरे, billable verifications हैं। यह idempotency key नहीं है।

Vehicle RC verify करें