> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polaris.supply/llms.txt
> Use this file to discover all available pages before exploring further.

# Counts

> Read public source and market totals.

Use this summary when you need a public coverage count rather than individual catalog rows.

## Request

```bash theme={null}
curl "https://api.polaris.supply/count"
```

## Access and behavior

`sources` is the global public source count, `markets` is the global public market count, and `by_source` maps each source ID to its public market count. This endpoint has no query parameters or pagination.

## Response

| Field | Type | Required | Description |
| - | - | - | - |
| `by_source` | `object` | Yes | — |
| `markets` | `integer` | Yes | — |
| `sources` | `integer` | Yes | — |
| `updatedAt` | `string` | Yes | — |

## Errors

The OpenAPI contract lists `503`, `429`. Error responses use `error.code`, `error.message`, and `error.resolution`. Follow `Retry-After` after `429`.

For the machine-readable contract, see the [OpenAPI document](https://api.polaris.supply/openapi.json).
