# Get registrar footprint

`GET https://api.unique.domains/v1/registrars/{registrar}/footprint`

Names tracked under the registrar on the latest footprint day, rounded, with its top endings.

From the scanner's footprint figures, keyed by IANA id; 404 for a registrar with no IANA id or no row.

- Access: A member key (Founder or Investor) or a paid RapidAPI subscription to this API.
- Billing: One call.
- Formats: JSON
- API: Registrar Prices API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `registrar` | string: namecheap, name.com, namesilo, porkbun, dynadot, cloudflare, spaceship, godaddy, unstoppable | Required | Path | A registrar catalog slug of the nine, exactly (`name.com`, no `name-com` alias). |
| `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/registrars/namecheap/footprint" \
  -H "Authorization: Bearer YOUR_MEMBER_KEY"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `registrar` | string |  |
| `day` | string |  |
| `names` | integer |  |
| `topEndings` | object[] |  |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`keyed_only`](https://unique.domains/api/problems/keyed_only) | 403 | A paid subscription is required |
| [`not_found`](https://unique.domains/api/problems/not_found) | 404 | Not found |
| [`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": {
    "registrar": "namecheap",
    "day": "2026-11-04",
    "names": 48300,
    "topEndings": [
      {
        "ending": "com",
        "names": 31200
      },
      {
        "ending": "io",
        "names": 2400
      }
    ]
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/registrars/namecheap/footprint",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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