DOCUMENTATION

Build with
GlobMaps API.

Production-ready geo-intelligence APIs for outbreak prediction, risk mapping, and supply chain visibility.

Introduction

GlobMaps provides production-ready geo-intelligence APIs for outbreak prediction, risk mapping, and supply chain visibility. All APIs return JSON responses with consistent envelopes.

Authentication

Include your API key in the X-API-Key header. Get your API key from the dashboard. All requests must include a valid key.

Quick Start

Make your first API call in minutes. Get risk data for Thailand with a simple GET request.

Endpoints

Explore our API endpoints for Risk Map, Outbreak Radar, and Supply Chain services.

Response Format

All responses follow a consistent envelope structure with requestId, asOf, data, and warnings.

Error Handling

Learn about error codes, validation rules, and how to handle rate limits.

Code Examples

cURL
curl -X GET "https://api.globmaps.com/v1/risk-data?regionId=TH" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json"
JavaScript
const response = await fetch('https://api.globmaps.com/v1/risk-data?regionId=TH', {
  headers: {
    'X-API-Key': 'your_api_key',
    'Content-Type': 'application/json'
  }
});
const data = await response.json();
Python
import requests

response = requests.get(
    'https://api.globmaps.com/v1/risk-data',
    params={'regionId': 'TH'},
    headers={'X-API-Key': 'your_api_key'}
)
data = response.json()

Response Format

{
  "requestId": "req_abc123",
  "asOf": "2026-04-19T10:30:00Z",
  "data": {},
  "warnings": []
}

Query Parameters

ParameterTypeDescription
localestring (default: en)en | th | zh
regionIdstringCountry or province code
asOfISO8601Timestamp for historical data

HTTP Status Codes

200Success
400Validation Error
401Unauthorized
404Not Found
429Rate Limited
500Server Error

Error Response

{
  "requestId": "req_abc123",
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid regionId",
    "details": {
      "field": "regionId"
    }
  }
}