Smart API Zone

PIN CODE VERIFICATION

Endpoint Version: 1.0.0 | Cost: ₹0.10 per call

Endpoint Route

GET https://api.rsprint.site/api/v1/gateway/pincode-verify

Description

Check postal delivery office name, district and division registered against Indian pin codes.

Request Headers

Header Name	Value / Type	Description
Content-Type	`string`	application/json
X-API-Key	`string`	your_api_key
X-API-Secret	`string`	your_api_secret

Request Parameters (JSON Body)

Parameter Name	Required Type	Constraint
pincode	`string`	6-digit postal PIN code (e.g. 800001)

Response Headers

Header	Sample Value
Content-Type	application/json; charset=utf-8
X-Execution-Time-Ms	45.82 ms

Error Codes mapping

Error Code	Description / Scenario
INVALID_PARAMETER	One or more query parameters are incorrectly formatted.
INSUFFICIENT_BALANCE	Your wallet balance is below the charge rate of this endpoint.

Code Integration

cURL Request Shell

NodeJS Axios Integration

const axios = require('axios');

axios.post('https://api.rsprint.site/api/v1/gateway/pincode-verify', [], {
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'X-API-Secret': 'YOUR_API_SECRET'
  }
}).then(res => console.log(res.data));

Python Requests Integration

import requests

url = 'https://api.rsprint.site/api/v1/gateway/pincode-verify'
headers = {
    'X-API-Key': 'YOUR_API_KEY',
    'X-API-Secret': 'YOUR_API_SECRET'
}
response = requests.post(url, json=[], headers=headers)
print(response.json())

PHP cURL Integration

<?php

$url = 'https://api.rsprint.site/api/v1/gateway/pincode-verify';
$headers = [
    'X-API-Key: YOUR_API_KEY',
    'X-API-Secret: YOUR_API_SECRET',
    'Content-Type: application/json'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '[]');

$res = curl_exec($ch);
echo $res;

Sample Success Response

{
    "status": "success",
    "data": {
        "pincode": "800001",
        "post_office": "Patna G.P.O.",
        "district": "Patna",
        "state": "Bihar"
    }
}

Sample Error Response

{
    "status": "error",
    "message": "Authentication failed or parameter invalid"
}