# Get meta freshness

`GET https://api.unique.domains/v1/meta/freshness`

How current the scanner's passes are: the day's counts and each lane's state.

Names scanned today and checked in the last 24 hours, and per scanner lane the names its current or last pass covered and whether it is running.

- Access: No key. Limited per address; a key adds the paid fields.
- Billing: One call.
- Formats: JSON

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `fields` | string | Optional | Query | Comma-separated top-level keys to keep; an unknown key answers 400 `unsupported_field`. |

## Sample request

```bash
curl -X GET "https://api.unique.domains/v1/meta/freshness"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `asOf` | string \| null |  |
| `scannedToday` | integer |  |
| `checkedLast24h` | integer |  |
| `lanes` | object[] |  |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`rate_limited`](https://unique.domains/api/problems/rate_limited) | 429 | Too many requests |
| [`internal`](https://unique.domains/api/problems/internal) | 500 | Unexpected error |

## Example answer

200, application/json

```json
{
  "data": {
    "asOf": "2026-11-05T06:00:00.000Z",
    "scannedToday": 1840022,
    "checkedLast24h": 611204,
    "lanes": [
      {
        "lane": "timing",
        "scanned": 402118,
        "state": "completed"
      },
      {
        "lane": "taken_refresh",
        "scanned": 88210,
        "state": "running"
      }
    ]
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/meta/freshness",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

API status: https://uniquedomains.instatus.com

Full reference: https://unique.domains/api