API Documentation

Welcome to the official zivan API documentation. Our RESTful APIs allow you to seamlessly integrate identity verification, banking, and utility services directly into your application with ultra-low latency.

Base URL for all API requests:
https://api.zivan.online/v1/

Authentication

All API requests require a Bearer token or API Key provided in the HTTP headers. You can generate your API Key from the Client Portal.

Headers

Authorization: Bearer YOUR_API_KEY_HERE
Content-Type: application/json

POST /verify/pan

PAN Card Verification API

Instantly verify a Permanent Account Number (PAN) against the central database to retrieve the name and status of the cardholder.

Request Parameters

Parameter	Type	Description
`pan_number`	String	The 10-character alphanumeric PAN to verify.
`consent`	Boolean	Must be `true`. Confirms user consent.

Example Request (cURL)

Bash

curl -X POST https://api.zivan.online/v1/verify/pan \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pan_number": "ABCDE1234F",
    "consent": true
  }'

Example Response (Success)

JSON

{
  "status": true,
  "message": "Verification Successful",
  "data": {
    "pan_number": "ABCDE1234F",
    "full_name": "JOHN DOE",
    "status": "VALID"
  }
}