# get_sunglasses_coverage

Describe what this service covers right now: brands, models, published variants, field completeness, offer coverage, freshness and which demo tasks have verified answers.

- REST: `GET https://sunglassesguides.com/api/v1/coverage` (OpenAPI operationId `get_sunglasses_coverage`)
- MCP: tool `get_sunglasses_coverage` on `https://sunglassesguides.com/mcp`
- Read-only: yes. It never changes anything outside this service.
- Market / units: US, USD, millimetres. Schema version 1.0.
- Support: implemented=true, data_covered=yes, externally_verified=false. Computed live from the published catalog.

## When to use

- Before relying on this service, to check whether a brand or task is in scope.
- To explain to a user why a search returned nothing.

## When not to use

- To search for frames (use find_sunglasses).

## Input

Path parameters: none. Query parameters: none.

No parameters.


## Output

The standard envelope (see [REST conventions](https://sunglassesguides.com/docs/rest.md)): `request_id`, `success`, `schema_version`, `data_version`, `data_mode`, `generated_at`, `request`, `result`, `sources`, `freshness`, `cache`, `next_actions`, and `error` on failure.

Counts computed from published records, field coverage, fit label definitions, offer coverage status, task_coverage_matrix and capability support flags.

`result.status` values: `COVERAGE`. `success:true` means the request was processed; it does not mean something matched.

## Sources and time

Each field carries `field_status`, `source_ids` and evidence excerpts; `sources[]` lists each cited source once with `retrieved_at`. `checked_at` is per record. See [freshness](https://sunglassesguides.com/docs/freshness.md).

## Permissions

Anonymous read-only trial without a key; optional API key for higher quotas. See [auth and quotas](https://sunglassesguides.com/docs/auth-and-quotas.md).

## Examples

### Example

```sh
curl -sS https://sunglassesguides.com/api/v1/coverage
```

Returns counts computed from published records (currently 81 published variants), field coverage, fit label definitions, offer coverage and the task coverage matrix.

## Related tools

- [find_sunglasses](https://sunglassesguides.com/docs/find_sunglasses.md)
- [resolve_sunglasses](https://sunglassesguides.com/docs/resolve_sunglasses.md)