Endpoint

POST /v1/verify/cin

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

Company CIN को validate और verify करता है। API key पर verification.cin.read scope ज़रूरी है। सफल response के बाद इसे cin.verify के रूप में metered किया जाता है - usage तभी दर्ज होता है (और priced services के लिए fulfilment wallet तभी debit होता है) जब verification सफलतापूर्वक पूरा हो जाए। नीचे दिया गया response /v1/verify/cin से लौटने वाला असली 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 भी स्वीकार किया जाता है।
`cin`ज़रूरी	`string`	Corporate Identification Number।

उदाहरण

Call करके देखें

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

Playground

Try करें

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

Response

Response का उदाहरण

ResponseJSON

{
  "referenceId": "SMV-20260927-6R38Y3",
  "valid": true,
  "companyName": "JANE DOE ENTERPRISES PRIVATE LIMITED",
  "incorporationDate": "2015-03-12",
  "cinStatus": "ACTIVE",
  "companyStatus": "Active",
  "directors": [
    {
      "din": "01234567",
      "name": "RAHUL KUMAR",
      "designation": "Director"
    }
  ],
  "email": "[email protected]",
  "registrationNumber": "U74999DL2015PTC284009",
  "incorporationCountry": "India"
}

Response के fields
Field	Type
`referenceId`	`string`
`valid`	`boolean`
`companyName`	`string`
`incorporationDate`	`string`
`cinStatus`	`string`
`companyStatus`	`string`
`directors`	`array`
`email`	`string`
`registrationNumber`	`string`
`incorporationCountry`	`string`

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": "cin must match the format U74999DL2015PTC284009",
    "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 नहीं है।

Company CIN verify करें