> For the complete documentation index, see [llms.txt](https://learn.spexi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.spexi.com/api-reference/coverage-api/query-coverage.md).

# GET Query coverage

## Query coverage

> Query coverage data by bounding box or point. Returns aggregated zones with coverage information. Pass ?entitled=true to return only data the authenticated user is entitled to.

```json
{"openapi":"3.0.3","info":{"title":"Spexi Developer API","version":"1.0.0"},"servers":[{"url":"https://world.spexi.com","description":"Production"}],"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key passed via request header. Either this or the `api_key` query parameter is required."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"api_key","description":"API key passed as a query parameter. Either this or the `x-api-key` header is required."}},"schemas":{"CoverageQueryResponse":{"type":"object","properties":{"zones":{"type":"array","items":{"type":"object","properties":{"h3Id":{"type":"string","description":"H3 cell identifier (zone hash)."},"captureTypes":{"type":"array","items":{"type":"string","enum":["panorama","orthomosaic","image"]},"description":"Capture types available in this zone."},"latestCapture":{"type":"string","format":"date-time","nullable":true,"description":"Most recent capture date in this zone (ISO 8601)."},"missionCount":{"type":"integer","description":"Number of missions contributing coverage to this zone."}},"required":["h3Id","captureTypes","latestCapture","missionCount"]},"description":"Matching zones, each aggregating coverage for one H3 cell."},"total":{"type":"integer","description":"Number of zones returned after applying the query limit."}},"required":["zones","total"]}}},"paths":{"/developer-api/coverage-map/query":{"get":{"description":"Query coverage data by bounding box or point. Returns aggregated zones with coverage information. Pass ?entitled=true to return only data the authenticated user is entitled to.","operationId":"CoverageController_queryCoverage","parameters":[{"name":"bbox","required":false,"in":"query","description":"Bounding box to query, in format minLon,minLat,maxLon,maxLat. Provide at least one of `bbox` or `point`; if both are supplied, `bbox` is used. Example: -123.2,49.1,-122.9,49.3","schema":{"type":"string"}},{"name":"point","required":false,"in":"query","description":"Point to query, in format lon,lat. Provide at least one of `bbox` or `point`; ignored when `bbox` is also supplied. Example: -123.1,49.25","schema":{"type":"string"}},{"name":"captureTypes","required":false,"in":"query","description":"Comma-separated list of capture types to filter by. Valid values: panorama, orthomosaic, image. Unrecognized values are ignored. Example: panorama,orthomosaic","schema":{"type":"string"}},{"name":"startDate","required":false,"in":"query","description":"Inclusive lower bound on capture date (ISO 8601). Example: 2024-01-01T00:00:00.000Z","schema":{"format":"date-time","type":"string"}},{"name":"endDate","required":false,"in":"query","description":"Inclusive upper bound on capture date (ISO 8601). Example: 2024-12-31T23:59:59.000Z","schema":{"format":"date-time","type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum number of zones to return. Must be between 1 and 1000. The default is 100.","schema":{"minimum":1,"maximum":1000,"default":100,"type":"integer"}},{"name":"entitled","required":false,"in":"query","description":"Filter by user entitlements (requires auth)","schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"description":"Coverage query results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoverageQueryResponse"}}}},"400":{"description":"Invalid query: missing bbox/point, malformed bbox/point format, or coordinates out of range"},"401":{"description":"Unauthorized - entitled=true requires authentication"}},"summary":"Query coverage","tags":["Coverage"]}}}}
```