Developer API

Ip API

The IP API provides a lightweight HTTP endpoint for applications that need IP-related lookup data through the Vismrit API platform. The active catalogue currently publishes a GET /ip route, while subscription and usage controls are handled by the standard API-key system.

Capabilities

What this API is designed to do

Simple IP lookup API exposed through the active GET /ip route.

Call the published GET /ip endpoint
Pass the IP-related input expected by the controller
Apply API-key and whitelist restrictions
Track daily and monthly request usage
Use cases

Where it can fit

These are common integration scenarios; choose the approach that fits your application and subscription plan.

Server-side IP lookup inside security or analytics workflows
Operational enrichment of request data
Developer utilities that need a simple IP API endpoint
Endpoint catalogue

Published routes and methods

Use the published routes and methods below when integrating this API.

MethodRoutePurpose
GET/ipIndex
Integration reference

Authentication, request shape and response handling

Use these examples as a quick integration reference and check the current API documentation before production use.

Authentication & access

Use Authorization: Bearer YOUR_API_KEY or X-API-Key. If the ip query parameter is omitted, the endpoint analyses the caller IP seen by the API service.

Example request
curl -X GET "https://api.sinhcoms.com/ip?ip=8.8.8.8" 
  -H "Authorization: Bearer YOUR_API_KEY"
Example response
{
  "ip": "8.8.8.8",
  "is_valid": true,
  "version": 4,
  "is_private": false,
  "is_reserved": false,
  "is_loopback": false,
  "hostname": null,
  "country": "...",
  "location": {},
  "city": "...",
  "asn": "...",
  "ip_risk": 0,
  "static_ip_score": 0
}
Error handling

Documented error states

400Invalid IP format
401API key authentication or product authorization failed
429Daily request limit exceeded
Integration flow

From subscription to first request

Use the customer dashboard as the control point for keys, whitelist rules and plan limits.

01

Subscribe to an IP API tier

02

Generate or reuse the appropriate API key

03

Whitelist the calling environment if required

04

Call GET /ip with the expected parameters

05

Handle response and rate-limit states in your application

Plans

Choose the request capacity you need

Pricing and limits below are read from the active subscription tiers in the API system.

Star

INR 499.00/month

  • 100,000 requests/day
  • 3,000,000 requests/month
Integration notes

Before you go live

Do not use IP-derived data as the sole basis for high-impact identity or access decisions. Treat it as contextual network information.