{ "openapi": "3.1.0", "info": { "title": "Enterprise API Portal API", "version": "1.0.0", "description": "Enterprise API marketplace for PAN, GST, RC, licence, bank and OCR verification plus a full print fulfilment portal. Wallet billing, instant API keys, 99.9% uptime.", "contact": { "email": "support@yourdomain.com" } }, "servers": [ { "url": "https://www.versatile-lavender-rat.163-61-39-39.cpanel.site", "description": "Production" } ], "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key" }, "ApiSecretAuth": { "type": "apiKey", "in": "header", "name": "X-API-Secret" } } }, "security": [ { "ApiKeyAuth": [] } ], "paths": { "/api/v1/instant-pan-find": { "post": { "operationId": "instant_pan_find", "summary": "INSTNT PAN FIND", "description": "Instant PAN discovery service. Submit the holder name, date of birth and registered mobile number and receive the matching Permanent Account Number along with a confidence score and the masked source record. Only exact and high-confidence matches are returned; low-confidence lookups are rejected and never charged.", "tags": [ "Identity Verification" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "success": true, "request_id": "req_8f21c0b4a7", "meta": { "charged": 6, "environment": "production", "balance": 4821.5, "response_ms": 312 }, "data": { "pan": "ABCDE1234F", "name": "RAHUL SHARMA", "dob": "1992-04-18", "category": "Individual", "match_score": 98, "status": "VALID" } } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "success": false, "request_id": "req_8f21c0b4a7", "error": { "code": "PAN_NOT_FOUND", "message": "No PAN record matched the supplied name and date of birth." }, "meta": { "charged": 0 } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 6, "x-rate-limit": "60/min", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "Full name of the PAN holder as printed on the card." }, "dob": { "type": "string", "description": "Date of birth in YYYY-MM-DD format." }, "mobile": { "type": "string", "description": "Registered 10-digit Indian mobile number. Improves match accuracy." } }, "required": [ "name", "dob" ] } } } } } }, "/api/v1/aadhaar-to-pan": { "get": { "operationId": "aadhaar_to_pan", "summary": "Aadhaar to PAN", "description": "Checks whether the supplied Aadhaar number is seeded with a PAN and returns the linked PAN along with the upstream application number.", "tags": [ "Identity Verification" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "aadhaar": "335400206902", "pan_no": "DSXPP7184N", "application_no": "FINDPAN_2511717720104", "message": "Entered Aadhaar number is already linked with a PAN" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "Given UID no not linked with any PAN" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 4.5, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key from the dashboard.", "schema": { "type": "string" } }, { "name": "aadhaar_no", "in": "query", "required": true, "description": "12-digit Aadhaar number. Must be exactly 12 digits.", "schema": { "type": "string" } } ] } }, "/api/v1/pan-details": { "get": { "operationId": "pan_details", "summary": "PAN Details", "description": "Validates a PAN against the registry and returns holder name, father name, date of birth and gender.", "tags": [ "Identity Verification" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "pan_no": "CFAPR3702R", "name": "SHAMSHER", "father": "", "dob": "1989-09-08", "gender": "M", "application_no": "PANDETAILS_5951729476665" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "No data found" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 1.5, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "panno", "in": "query", "required": true, "description": "Valid PAN number (e.g. CFAPR3702R).", "schema": { "type": "string" } } ] } }, "/api/v1/mobile-to-pan": { "get": { "operationId": "mobile_to_pan", "summary": "Mobile to PAN", "description": "Matches the customer name and registered mobile number against the PAN registry and returns the PAN.", "tags": [ "Identity Verification" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "message": "Success", "name": "Mohan Kumar Singh", "mobile_no": "8000000066", "pan_number": "DAFPS3123A", "application_no": "MOB2PAN_286F046A299911A2", "amount": "10.00", "balance_left": "27175.27" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "Record not found" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 15, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "Name", "in": "query", "required": true, "description": "Customer name.", "schema": { "type": "string" } }, { "name": "MobileNo", "in": "query", "required": true, "description": "10-digit mobile number.", "schema": { "type": "string" } } ] } }, "/api/v1/up-ration-to-aadhaar": { "get": { "operationId": "up_ration_to_aadhaar", "summary": "UP Ration to Aadhaar", "description": "Returns every family member on the Uttar Pradesh ration card with name, relation, DOB, gender and UID.", "tags": [ "Identity Verification" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "message": "Success", "data_mode": "mix", "source": "cache", "billable": "Y", "ration_no": "215740456718", "family": [ { "name": "Rama Devi", "relation": "Self", "dob": "01/02/1984", "uid": "601627856586", "gender": "Female", "father_name": "RAM KISHUN" } ], "application_no": "UPR2UID_8C66CB645E251493", "amount": "10.00", "balance_left": "27191.27" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "Record not found" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 15, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "ration_no", "in": "query", "required": true, "description": "12-digit UP ration card number.", "schema": { "type": "string" } } ] } }, "/api/v1/voter-mobile-link": { "get": { "operationId": "voter_mobile_link", "summary": "Voter Mobile Link", "description": "Submits an instant mobile-linking request for the given EPIC number and returns a ref_id for tracking.", "tags": [ "Identity Verification" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "message": "Number linked pending Complete within 5 min", "epic": "TMM0007133", "mobile": "7250000919", "ref_id": "S12093V8C2506261200002", "application_no": "VMLINK_994E5C7646B1F4D1", "amount": "5.00", "balance_left": "27216.27" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "Request Failed" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 7.5, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "epic", "in": "query", "required": true, "description": "Voter EPIC number.", "schema": { "type": "string" } }, { "name": "mobile", "in": "query", "required": true, "description": "10-digit mobile number.", "schema": { "type": "string" } } ] } }, "/api/v1/pan-to-aadhaar-search": { "post": { "operationId": "pan_to_aadhaar_search", "summary": "PAN TO AADHAAR SEARCH", "description": "Returns the linking status between a PAN and the identifier seeded against it, with the masked identifier and the last seeding date. Full identifiers are never returned.", "tags": [ "Identity Verification" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "success": true, "request_id": "req_8f21c0b4a7", "meta": { "charged": 5, "environment": "production", "balance": 4821.5, "response_ms": 312 }, "data": { "pan": "ABCDE1234F", "linked": true, "id_masked": "XXXXXXXX1234", "seeded_on": "2023-06-19", "name": "RAHUL SHARMA" } } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "success": false, "request_id": "req_8f21c0b4a7", "error": { "code": "NOT_LINKED", "message": "No identifier is seeded against this PAN." }, "meta": { "charged": 0 } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 5, "x-rate-limit": "60/min", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "pan": { "type": "string", "description": "10-character PAN, e.g. ABCDE1234F." }, "consent": { "type": "string", "description": "Must be \"Y\" to confirm the holder has given consent." } }, "required": [ "pan", "consent" ] } } } } } }, "/api/v1/pan-to-aadhaar": { "get": { "operationId": "pan_to_aadhaar", "summary": "PAN to Aadhaar", "description": "Returns the Aadhaar number seeded with the PAN plus name, date of birth and gender.", "tags": [ "Identity Verification" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "message": "Success", "pan_number": "JAYPP5910H", "data": { "pan_number": "JAYPP5910H", "aadhaar_number": "792452291769", "dob": "2007-08-05", "name": "ARUSHI PATEL", "Gender": "F" }, "application_no": "PAN2ADR_37A899510A0DE174", "amount": "5.00", "balance_left": "49761.77" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "Request Failed" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 7.5, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "pan_number", "in": "query", "required": true, "description": "10-character PAN number.", "schema": { "type": "string" } } ] } }, "/api/v1/npci-status": { "get": { "operationId": "npci_status", "summary": "NPCI Status", "description": "Returns the NPCI mapper record (bank name, status, last updated) plus masked UIDAI holder information.", "tags": [ "Banking & Payments" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "message": "Success", "aadhaar": "225900003211", "npcidata": { "bank_Name": "CENTRAL CO OPERATIVE BANK LTD ARA", "status": "A", "last_Updated_Date": "2017-11-02T19:39:11" }, "uidaidata": { "uid": "225900003211", "name": "Mohan Kumar Singh", "localName": "विनय कुमार सिह", "mobile": "XXXXXX00000" }, "application_no": "NPCI_718C939B298AAC19", "amount": "6.00", "balance_left": "27185.27" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "Record not found" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 9, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "aadhaar", "in": "query", "required": true, "description": "12-digit Aadhaar number.", "schema": { "type": "string" } } ] } }, "/api/v1/bank-ifsc-details": { "get": { "operationId": "bank_ifsc_details", "summary": "BANK IFSC DETAILS", "description": "Directory lookup that resolves an IFSC code to the bank name, branch, full address, city, district, state, contact number, MICR code and the supported payment rails (NEFT, RTGS, IMPS, UPI).", "tags": [ "Banking & Payments" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "success": true, "request_id": "req_8f21c0b4a7", "meta": { "charged": 0.5, "environment": "production", "balance": 4821.5, "response_ms": 312 }, "data": { "ifsc": "HDFC0001234", "bank": "HDFC BANK", "branch": "KORAMANGALA", "address": "80 Feet Road, Koramangala, Bengaluru", "city": "BENGALURU", "district": "BENGALURU URBAN", "state": "KARNATAKA", "contact": "080-41156789", "micr": "560240012", "neft": true, "rtgs": true, "imps": true, "upi": true } } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "success": false, "request_id": "req_8f21c0b4a7", "error": { "code": "IFSC_NOT_FOUND", "message": "No branch found for the supplied IFSC code." }, "meta": { "charged": 0 } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 0.5, "x-rate-limit": "60/min", "parameters": [ { "name": "ifsc", "in": "query", "required": true, "description": "11-character IFSC, e.g. HDFC0001234.", "schema": { "type": "string" } } ] } }, "/api/v1/ifsc-details": { "get": { "operationId": "ifsc_details", "summary": "IFSC Details", "description": "Returns bank, branch, address, city, district, state and NEFT/RTGS/IMPS/UPI support flags.", "tags": [ "Banking & Payments" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "message": "Success", "ifsc": "PUNB0MBGB06", "data": { "BANK": "Dakshin Bihar Gramin Bank", "BRANCH": "Dakshin Bihar Gramin Bank IMPS", "CITY": "MUMBAI", "DISTRICT": "PATNA", "STATE": "MAHARASHTRA", "ADDRESS": "HO SHRI VISHNU COMMERCIAL COMPLEX, NEW BYPASS, NH-30, ASHOCHAK", "CONTACT": "+916122385421", "IFSC": "PUNB0MBGB06", "IMPS": true, "NEFT": true, "RTGS": true, "UPI": true }, "application_no": "IFSC_8DB6C91A782CF902", "amount": "0.50", "balance_left": "49761.27" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "Request Failed" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 0.75, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "ifsc", "in": "query", "required": true, "description": "11-character IFSC code.", "schema": { "type": "string" } } ] } }, "/api/v1/dl-pdf": { "post": { "operationId": "dl_pdf", "summary": "DL PDF", "description": "Fetches the driving licence record for a licence number and date of birth and renders a ready-to-print PDF containing holder details, classes of vehicle, issuing RTO, validity dates and the current licence status. The response carries a signed, time-limited download URL plus the structured record.", "tags": [ "Vehicle & Transport" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "success": true, "request_id": "req_8f21c0b4a7", "meta": { "charged": 3, "environment": "production", "balance": 4821.5, "response_ms": 312 }, "data": { "dl_number": "MH1220110012345", "name": "RAHUL SHARMA", "dob": "1992-04-18", "issuing_rto": "RTO PUNE (MH12)", "vehicle_classes": [ "LMV", "MCWG" ], "valid_from": "2011-06-02", "valid_upto": "2031-06-01", "status": "ACTIVE", "pdf_url": "https://cdn.example.com/pdf/dl/8f21c0b4.pdf", "pdf_expires_in": 900 } } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "success": false, "request_id": "req_8f21c0b4a7", "error": { "code": "DL_NOT_FOUND", "message": "No licence record found for this number and date of birth." }, "meta": { "charged": 0 } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 3, "x-rate-limit": "60/min", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dl_number": { "type": "string", "description": "Driving licence number, e.g. MH1220110012345." }, "dob": { "type": "string", "description": "Holder date of birth in YYYY-MM-DD format." } }, "required": [ "dl_number", "dob" ] } } } } } }, "/api/v1/rc-pdf": { "post": { "operationId": "rc_pdf", "summary": "RC PDF", "description": "Returns the complete registration certificate for a vehicle number as a print-ready PDF together with the structured record: owner name, maker and model, fuel type, registration and fitness dates, insurance and PUC validity, and blacklist status.", "tags": [ "Vehicle & Transport" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "success": true, "request_id": "req_8f21c0b4a7", "meta": { "charged": 6, "environment": "production", "balance": 4821.5, "response_ms": 312 }, "data": { "rc_number": "MH12AB1234", "owner_name": "RAHUL SHARMA", "maker_model": "MARUTI SUZUKI SWIFT VXI", "fuel_type": "PETROL", "vehicle_class": "LMV", "registration_date": "2021-03-18", "fitness_upto": "2036-03-17", "insurance_valid_upto": "2026-03-17", "puc_valid_upto": "2026-09-10", "blacklist_status": "NA", "pdf_url": "https://cdn.example.com/pdf/rc/8f21c0b4.pdf", "pdf_expires_in": 900 } } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "success": false, "request_id": "req_8f21c0b4a7", "error": { "code": "RC_NOT_FOUND", "message": "Vehicle record unavailable at source." }, "meta": { "charged": 0 } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 6, "x-rate-limit": "60/min", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "rc_number": { "type": "string", "description": "Vehicle registration number without spaces, e.g. MH12AB1234." } }, "required": [ "rc_number" ] } } } } } }, "/api/v1/vehicle-challan": { "get": { "operationId": "vehicle_challan", "summary": "Vehicle Challan", "description": "Returns every available e-challan for the vehicle including owner name, state, department, amount, status and payment date.", "tags": [ "Vehicle & Transport" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "message": "Success", "vehicle_number": "HR03AM4335", "challan_count": 6, "challans": [ { "state": "Bihar", "challan_no": "BR449326084075", "owner_name": "MOHAN SINGH", "department": "Traffic", "office_name": "Patna", "challan_status": "Paid", "challan_amount": 1000, "payment_source": "ONLINE", "payment_date": "2025-10-26", "challan_place": "AIIMS_GOLUMBER_ANPR", "vehicle_class": "M-Cycle/Scooter(2WN)" } ], "application_no": "VCHALLAN_3DDE206E46E4AEBF", "amount": "10.00", "balance_left": "27145.27" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "No Challan Found" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 15, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "vehicle_number", "in": "query", "required": true, "description": "Vehicle registration number.", "schema": { "type": "string" } } ] } }, "/api/v1/ll-exam": { "get": { "operationId": "ll_exam", "summary": "LL Exam", "description": "Queues a learner licence exam request. Save the returned order_id to poll the status endpoint later.", "tags": [ "Vehicle & Transport" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "message": "Success", "application_no": "appno004", "password": "44hfgh1", "order_id": "LLEXAM_1327E8C1D5245CD2", "amount": "80.00", "balance_left": "37201.27" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "Request Failed" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 120, "x-rate-limit": "30/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "appno", "in": "query", "required": true, "description": "Application number.", "schema": { "type": "string" } }, { "name": "password", "in": "query", "required": true, "description": "Application password.", "schema": { "type": "string" } }, { "name": "dob", "in": "query", "required": true, "description": "Date of birth (DD-MM-YYYY).", "schema": { "type": "string" } } ] } }, "/api/v1/ll-exam-status": { "get": { "operationId": "ll_exam_status", "summary": "LL Exam Status", "description": "Status can be PENDING, COMPLETED or REJECTED. Completed requests include an attachment_url; rejected requests include refund details.", "tags": [ "Vehicle & Transport" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "order_id": "LLEXAM_FFFA9F23776BFB3F", "status": "COMPLETED", "application_no": "appno002", "attachment_url": "https://server195154.ddns.net/uploads/llexam_2_1784428257_a18451f1.png" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "order_id": "LLEXAM_1327E8C1D5245CD2", "status": "REJECTED", "application_no": "appno004", "remark": "Password Wrong", "is_refunded": "1", "refund_txn_id": "LLEXAM_1327E8C1D5245CD2_REFUND", "refund_date": "2026-07-19" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 0, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": false, "description": "Your API key (sent automatically by the portal).", "schema": { "type": "string" } }, { "name": "order_id", "in": "query", "required": true, "description": "Order ID received from the LL Exam API.", "schema": { "type": "string" } } ] } }, "/api/v1/rc-print": { "get": { "operationId": "rc_print", "summary": "RC Print", "description": "Fetches the RC record for a vehicle number and renders a print-ready card. The pdf field is a base64 data URI.", "tags": [ "Documents & PDF" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "rcno": "BR03L8594", "name": "VINAY KUMAR SINGH", "application_no": "RCPRINT_4601717997098", "message": "RC verification successful", "pdf": "data:application/pdf;base64,JVBERi0xLjQKJb662+=" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "RC verification failed" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 4.5, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "rcno", "in": "query", "required": true, "description": "Vehicle registration number.", "schema": { "type": "string" } }, { "name": "cardtype", "in": "query", "required": false, "description": "1 = Old Background, 2 = New Background.", "schema": { "type": "string" } }, { "name": "chiptype", "in": "query", "required": false, "description": "1 = Chip, 2 = Non-Chip.", "schema": { "type": "string" } } ] } }, "/api/v1/dl-print": { "get": { "operationId": "dl_print", "summary": "DL Print", "description": "Returns a print-ready driving licence card as a base64 PDF data URI.", "tags": [ "Documents & PDF" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "pdf": "data:application/pdf;base64,JVBERi0xLjQKJb662+=", "application_no": "RCPRINT_4601717997098", "message": "DL Print Successfully" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "DL Not found" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 4.5, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "dlno", "in": "query", "required": true, "description": "Driving Licence number.", "schema": { "type": "string" } }, { "name": "dob", "in": "query", "required": true, "description": "Date of birth in DD-MM-YYYY format.", "schema": { "type": "string" } }, { "name": "cardtype", "in": "query", "required": false, "description": "1 = White Background, 2 = Light Blue Background.", "schema": { "type": "string" } }, { "name": "state", "in": "query", "required": false, "description": "JK = Jammu & Kashmir design layout.", "schema": { "type": "string" } } ] } }, "/api/v1/ration-print": { "get": { "operationId": "ration_print", "summary": "Ration Print", "description": "Unlike RC/DL, this endpoint returns a hosted pdf_url link instead of base64 content.", "tags": [ "Documents & PDF" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "application_no": "4601717997098", "pdf_url": "https://www.apicentre.in/files?ration=22917", "message": "Ration verification successful" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "Ration verification failed" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 4.5, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "rationno", "in": "query", "required": true, "description": "Ration card number.", "schema": { "type": "string" } }, { "name": "card_type", "in": "query", "required": false, "description": "1 = Photo Design, 2 = Simple Design.", "schema": { "type": "string" } } ] } }, "/api/v1/agristack-farmer-pdf": { "get": { "operationId": "agristack_farmer_pdf", "summary": "Agristack Farmer PDF", "description": "Agristack farmer registry verification. Returns the farmer PDF as a base64 data URI plus billing metadata.", "tags": [ "Documents & PDF" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "message": "Agristack verification successful", "data_mode": "mix", "source": "cache", "billable": "Y", "aadhaar": "335400206902", "name": "Chandra Bhushan", "application_no": "FARMER_B87614A2A0A4F094", "amount": "0.50", "balance_left": "27247.27", "pdf": "data:application/pdf;base64,...." } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "Verification failed" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 0.75, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "aadhaar", "in": "query", "required": true, "description": "12-digit Aadhaar number.", "schema": { "type": "string" } }, { "name": "state", "in": "query", "required": true, "description": "State code (example: BR, UP, DL, MH).", "schema": { "type": "string" } } ] } }, "/api/v1/pan-to-gst-search": { "post": { "operationId": "pan_to_gst_search", "summary": "PAN TO GST SEARCH", "description": "Maps a PAN to all GST registrations issued against it, returning each GSTIN with its state, registration status and authority. Useful for onboarding checks and vendor de-duplication.", "tags": [ "Business & Tax" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "success": true, "request_id": "req_8f21c0b4a7", "meta": { "charged": 0.5, "environment": "production", "balance": 4821.5, "response_ms": 312 }, "data": { "pan": "AAECS1234F", "count": 2, "gstin_list": [ { "gstin": "27AAECS1234F1Z5", "state": "Maharashtra", "status": "Active" }, { "gstin": "29AAECS1234F1Z1", "state": "Karnataka", "status": "Cancelled" } ] } } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "success": false, "request_id": "req_8f21c0b4a7", "error": { "code": "GSTIN_NOT_FOUND", "message": "No GST registration is mapped to this PAN." }, "meta": { "charged": 0 } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 0.5, "x-rate-limit": "60/min", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "pan": { "type": "string", "description": "10-character PAN of the business or person." } }, "required": [ "pan" ] } } } } } }, "/api/v1/pan-to-gst": { "get": { "operationId": "pan_to_gst", "summary": "PAN to GST", "description": "Lists every GST registration mapped to the PAN with GSTIN, authorisation status and state.", "tags": [ "Business & Tax" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "message": "Success", "data_mode": "mix", "source": "live", "billable": "Y", "pan": "DPVPP9203R", "count": 2, "items": [ { "gstin": "20DPVPP9203R1Z1", "auth_status": "Active", "state": "JHARKHAND" } ], "application_no": "PAN2GST_C2A38EA26CFD5D9A", "amount": "0.50", "balance_left": "49768.27" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "Request Failed" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 0.75, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "pan", "in": "query", "required": true, "description": "10-character PAN number.", "schema": { "type": "string" } } ] } }, "/api/v1/gst-details": { "get": { "operationId": "gst_details", "summary": "GST Details", "description": "Returns legal name, constitution, taxpayer type, status, registration date and state jurisdiction for the GSTIN.", "tags": [ "Business & Tax" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "message": "Success", "gst": "20DPVPP9203R1Z1", "details": { "gstin": { "value": "20DPVPP9203R1Z1" }, "legal_name": { "value": "SURAJ KUMAR PANDIT" }, "constitution": { "value": "Proprietorship" }, "status": { "value": "Active" }, "tax_payer_type": { "value": "Regular" }, "registration_date": { "value": "2020-06-15T00:00:00+05:30" }, "state_jurisdiction": { "value": "Koderma" } }, "application_no": "GSTDET_059C46D030AA7E01", "amount": "0.50", "balance_left": "49766.77" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "404", "message": "Request Failed" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 0.75, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API key.", "schema": { "type": "string" } }, { "name": "gst", "in": "query", "required": true, "description": "15-character GSTIN number.", "schema": { "type": "string" } } ] } }, "/api/v1/balance": { "get": { "operationId": "balance", "summary": "Balance Check", "description": "Returns the live APIZONE wallet balance together with the account username. Use it for low-balance monitoring before routing paid lookups.", "tags": [ "Wallet & Utility" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "Balance": "145076.50", "username": "1234567901" } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "401", "message": "API User Not Found" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 0, "x-rate-limit": "60/min", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your unique API key from the dashboard.", "schema": { "type": "string" } } ] } }, "/api/v1/place-order": { "post": { "operationId": "place_order", "summary": "Place Order", "description": "Creates an upstream order for the given service id, target link and quantity. The response contains the upstream order id used for status tracking.", "tags": [ "Wallet & Utility" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "example": { "status": "200", "order": 89432 } } } }, "400": { "description": "Validation or upstream error", "content": { "application/json": { "example": { "status": "400", "message": "Insufficient Balance" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Insufficient wallet balance" }, "429": { "description": "Rate limit exceeded" } }, "x-price-inr": 0, "x-rate-limit": "30/min", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "api_key": { "type": "string", "description": "Your API key." }, "service": { "type": "integer", "description": "Service ID from the services list." }, "link": { "type": "string", "description": "Target URL (profile, post, video, etc.)." }, "quantity": { "type": "integer", "description": "Number of units to order." } }, "required": [ "api_key", "service", "link", "quantity" ] } } } } } } } }