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

# List domains

> Read the public domain id for this Private API Key.

Call this before Search or Card. Use the returned `id` as `{domain_id}`. That value is a UUID. `domain` is the hostname and is not a path value. A site key returns one row. The literal `all` is not a domain id.

```bash theme={null}
curl 'https://account.shieldlabs.ai/api/v1/domains' \
  -H "Authorization: Bearer $SHIELDLABS_API_KEY"
```

```json theme={null}
{
  "domains": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "domain": "myshop.com"
    }
  ]
}
```

## Authentication

**Authorization** `string` *required*

`Bearer PRIVATE_API_KEY`. Use the domain's Private API Key.

## Response

**domains** `object[]` *required*

Domains visible to this key.

**domains.id** `string` *required*

Public domain id. Pass it as `{domain_id}` on [Search](https://docs.shieldlabs.ai/api/history-search.md) and [Card](https://docs.shieldlabs.ai/api/history-card.md).

**domains.domain** `string` *required*

Registered hostname.

The read does not consume identification quota. The History API allows 15 requests per second per domain.

## Errors

| Status | Meaning |
| - | - |
| `401` | Missing or invalid Private API Key |
| `429` | Domain request limit reached |
| `500` | History or authentication lookup failure |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.