GET /coverage

Returns the geographic coverage of the API, with data availability statistics by country and region.

Endpoint

GET https://places.gotravelyzer.com/coverage

Authentication

This endpoint does not require authentication and is not counted against your quotas.

Parameters

No parameters required.

Request

curl "https://places.gotravelyzer.com/coverage"

Response

Success (200 OK)

{
  "lastUpdated": "2026-02-23T00:00:00.000Z",
  "totalCountries": 195,
  "regions": {
    "europe": {
      "countries": 44,
      "coverage": 99.5,
      "topCountries": ["France", "Germany", "United Kingdom", "Spain", "Italy"]
    },
    "northAmerica": {
      "countries": 23,
      "coverage": 99.2,
      "topCountries": ["United States", "Canada", "Mexico"]
    },
    "asia": {
      "countries": 48,
      "coverage": 97.8,
      "topCountries": ["Japan", "South Korea", "China", "India", "Thailand"]
    },
    "southAmerica": {
      "countries": 12,
      "coverage": 96.5,
      "topCountries": ["Brazil", "Argentina", "Chile", "Colombia"]
    },
    "africa": {
      "countries": 54,
      "coverage": 92.3,
      "topCountries": ["South Africa", "Egypt", "Morocco", "Kenya", "Nigeria"]
    },
    "oceania": {
      "countries": 14,
      "coverage": 98.1,
      "topCountries": ["Australia", "New Zealand"]
    }
  },
  "global": {
    "addressCoverage": 97.5,
    "poiCoverage": 94.2,
    "roadCoverage": 98.8
  }
}

Response Fields

Metadata

Field	Type	Description
`lastUpdated`	`string`	Last data update date (ISO 8601)
`totalCountries`	`number`	Total number of countries covered

Regions

Field	Type	Description
`regions.[region].countries`	`number`	Number of countries in the region
`regions.[region].coverage`	`number`	Coverage percentage (0-100)
`regions.[region].topCountries`	`string[]`	Countries with best coverage

Global Coverage

Field	Type	Description
`global.addressCoverage`	`number`	Address coverage (%)
`global.poiCoverage`	`number`	Points of interest coverage (%)
`global.roadCoverage`	`number`	Road coverage (%)

HTTP Codes

Code	Status	Description
`200`	OK	Coverage data returned
`503`	Service Unavailable	Service unavailable

Use Cases

Check Country Coverage

Before integrating the API in a new market, check coverage:

#!/bin/bash
 
COVERAGE=$(curl -s "https://places.gotravelyzer.com/coverage")
 
echo "=== GLOBAL COVERAGE ==="
echo "Countries covered: $(echo $COVERAGE | jq '.totalCountries')"
echo "Addresses: $(echo $COVERAGE | jq '.global.addressCoverage')%"
echo "Points of interest: $(echo $COVERAGE | jq '.global.poiCoverage')%"
echo "Roads: $(echo $COVERAGE | jq '.global.roadCoverage')%"
echo ""
echo "=== COVERAGE BY REGION ==="
echo $COVERAGE | jq -r '.regions | to_entries[] | "\(.key): \(.value.coverage)%"'

Display Top Countries by Region

#!/bin/bash
 
COVERAGE=$(curl -s "https://places.gotravelyzer.com/coverage")
 
echo "Top countries by region:"
echo $COVERAGE | jq -r '.regions | to_entries[] | "\(.key | ascii_upcase):\n  \(.value.topCountries | join(", "))\n"'

Monitor Coverage Updates

#!/bin/bash
 
COVERAGE=$(curl -s "https://places.gotravelyzer.com/coverage")
 
LAST_UPDATE=$(echo $COVERAGE | jq -r '.lastUpdated')
echo "Last data update: $LAST_UPDATE"
 
# Check if data is recent (less than 7 days)
UPDATE_DATE=$(date -d "$LAST_UPDATE" +%s 2>/dev/null || date -j -f "%Y-%m-%dT%H:%M:%S" "${LAST_UPDATE%.*}" +%s)
CURRENT_DATE=$(date +%s)
DAYS_OLD=$(( (CURRENT_DATE - UPDATE_DATE) / 86400 ))
 
if [ $DAYS_OLD -gt 7 ]; then
  echo "Warning: Data is more than $DAYS_OLD days old"
else
  echo "Data is up to date (${DAYS_OLD} days old)"
fi

Interpreting Data

Coverage Score

Score	Interpretation
95-100%	Excellent - Complete coverage
90-95%	Very good - Some rural areas missing
80-90%	Good - Urban areas well covered
70-80%	Acceptable - Mainly major cities
< 70%	Limited - Partial coverage

Data Types

Type	Description
Addresses	Street numbers, buildings, postal codes
POI	Major points of interest (monuments, airports, stations, etc.)
Roads	Streets, highways, paths

Available Regions

Region	Code
Europe	`europe`
North America	`northAmerica`
South America	`southAmerica`
Asia	`asia`
Africa	`africa`
Oceania	`oceania`

Technical Notes

Coverage data is updated daily
Percentages are based on data density relative to population
This endpoint is not subject to rate limits
Coverage may vary between urban/rural areas

Next Steps

Forward Geocoding

Start geocoding addresses.

SLA Metrics

See real-time performance.

Health Check

Check service status.