IndiaGeoAPI

API Documentation

Navigation

Location API Overview
A comprehensive RESTful API for managing location data with support for CRUD operations, search functionality, and geospatial queries.
99.9%
Uptime
<50ms
Response Time
1000/min
Rate Limit
Authentication
All API requests require authentication using an API key in the request header.

Required Header:

x-api-key:YOUR_API_KEY
// Example with fetch
fetch('https://desam.api.co/api/v1/locations/locations', {
  headers: {
    'x-api-key':'YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

// Example with curl
curl -H "x-api-key:YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://desam.api.co/api/v1/locations/locations
Base URL
https://desam.api.co/api/v1/locations

API Endpoints

GET/locations/search/:location
Retrieve a list of locations with optional filtering and pagination.
such as use params states , cities, or localities.

Query Parameters

:locationFilter by states, cities, or localities.
pagePage number (default: 1)
limitItems per page (default: 20, max: 100)
GET/locations/search
Search locations by name with pagination.

Query Parameters

nameSearch query (name or address)
limitMaximum number of results (default: 10)
PagePage number (default: 0)
POSTlocations/localities
Get Current locations by latitude and longitude.

Body Parameters (JSON)

latLatitude for proximity search
lngLongitude for proximity search
radiusSearch radius in kilometers (default: 10)
Error Codes
Standard HTTP status codes and error responses.
400Bad Request
401Unauthorized
403Forbidden
404Not Found
422Validation Error
429Rate Limited
500Internal Server Error
503Service Unavailable

Error Response Format

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request data",
    "details": [
      {
        "field": "coordinates.latitude",
        "message": "Latitude must be between -90 and 90"
      }
    ]
  }
}
Rate Limits
API usage limits and best practices.
1000
Requests per minute
50,000
Requests per day
10
Concurrent requests

Rate Limit Headers

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200