Status: Available Now

Endpoint: POST /api/v1/by-administrative-boundaries

Purpose: Retrieve market data for charging infrastructure within administrative boundaries

Overview

The country-based search endpoint will enable analysis of electric vehicle charging infrastructure by administrative boundaries such as countries. This endpoint is designed for national market analysis, policy research, and large-scale regional comparisons.

Key Capabilities

• Country-level searches using ISO country codes
• Flexible data export formats (JSON and CSV)
• Historical data for specific months/years
• Optional filtering by power specifications
• Paginated results for large datasets

Request Format

HTTP Method

POST /api/v1/by-administrative-boundaries

Headers

Content-Type: application/json
Accept: application/json  # or text/csv for CSV format
x-api-key: your-api-key-here

Request Body Schema

{
  "boundary": {
    "countryCode": "string" // Required: ISO 3166-1 alpha-3 (e.g., "DEU", "FRA")
  },
  "period": {
    "year": integer,   // Required: Year (e.g. "2025" within last 12 months)
    "month": integer   // Required: Month (1-12)
  },
  "powerSpecification": {     // Optional filtering
    "type": "string",         // Optional: "AC" or "DC"
    "powerRangeKw": {         // Optional: Power range filter
      "min": number, // e.g. "20.4"
      "max": number // e.g. "500.0"
    }
  },
  "skip": integer,    // Optional: Pagination offset (default: 0)
  "limit": integer    // Optional: Results per page, 1-100 (default: 50)
}

Parameter Details