Government Agencies API Enterprise Data Access

Complete documentation for government officials to access business intelligence data with military-grade security protocols

REST API Secure JSON
v1.0.0
Get Started View Endpoints

Secure Government Data Access

Enterprise-grade API designed specifically for government agencies to access business intelligence data with military-grade security.

100%
Secure
Real-time
Data
State-based
Access
24/7
Available
Business Intelligence

Access comprehensive business listings, sector data, and industry analytics for informed decision-making.

State-based Real-time Structured
User Analytics

Get detailed user statistics, demographics, and engagement metrics to understand your constituency.

Demographics Engagement Trends
Sector Insights

Deep dive into business sectors, subsectors, and industry trends for economic analysis.

Sectors Subsectors Growth
Data Access Overview
Available Data
  • Business Listings - Complete business information by state
  • User Analytics - User statistics and demographics by state
  • Sector Data - Business sector and subsector breakdowns
  • Real-time Updates - Live data from our platform
Access Control
  • State-based Access - Only data from your assigned states
  • Real-time Data - Always up-to-date information
  • Secure Access - Military-grade authentication
  • Analytics Ready - Structured for easy analysis
Enterprise Security Features
🔐 Secure Authentication

API Key + Secret required for all requests with encrypted transmission

🛡️ IP Whitelisting

Restrict access to specific networks with flexible CIDR and wildcard support

⚡ Rate Limiting

Configurable request limits per hour with real-time monitoring

Step 1: Get Credentials

Contact admin to receive your API Key and Secret

Step 2: Test Connection

Verify your setup with a health check

Step 3: Access Data

Start retrieving business and user data

Quick Test Commands:
# Health check
curl -X GET "https://your-domain.com/api/government/v1/health"

# Get your states
curl -X GET "https://your-domain.com/api/government/v1/states" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"
GET /businesses Get business listings by state

Parameters:

  • state (required) - State name
  • sector (optional) - Business sector
  • subsector (optional) - Business subsector

Example:

curl -X GET "https://your-domain.com/api/government/v1/businesses?state=Lagos" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"
GET /users Get user analytics by state

Parameters:

  • state (required) - State name

Example:

curl -X GET "https://your-domain.com/api/government/v1/users?state=Ogun" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"
GET /analytics Get sector analytics by state

Parameters:

  • state (required) - State name

Example:

curl -X GET "https://your-domain.com/api/government/v1/analytics?state=Ondo" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"
Security Features

Your API access is protected by multiple security layers to ensure data privacy and prevent unauthorized access.

Authentication
  • API Key: Unique identifier for your agency
  • API Secret: Secure password for authentication
  • Required: Both must be included in every request
IP Whitelisting
  • Network Restriction: Only specific IPs can access
  • Flexible Rules: Support for ranges and wildcards
  • Priority System: Blocked IPs override allowed ones
IP Address Examples:
Single IP:
192.168.1.100
Network Range:
10.0.0.0/24
Wildcard:
192.168.*.*
Common Use Cases

Here are practical examples of how to use the API for different scenarios.

Business Research

Goal: Get all technology businesses in Lagos

curl -X GET "https://your-domain.com/api/government/v1/businesses?state=Lagos§or=Technology" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"
Analytics Report

Goal: Generate user statistics report for Ogun State

curl -X GET "https://your-domain.com/api/government/v1/users?state=Ogun" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"
Testing Your Setup:
  1. Health Check: Verify API is accessible
  2. State Access: Confirm your assigned states
  3. Data Retrieval: Test actual data access
  4. Error Handling: Test with invalid parameters