# Asset Whois History List

GET /easm/assets/{asset_id}/whois-history: Lists the WHOIS snapshots recorded for an asset (newest first): id and check_date of each.

Source: https://docs.deepinfo.com/reference/easm/asset-whois-history-list/

Last updated: 2026-09-27

---
`GET https://api.deepinfo.com/v1/easm/assets/{asset_id}/whois-history`

Lists the WHOIS snapshots recorded for an asset (newest first): `id` and `check_date` of each.

## Authentication

Send your API key in the `apikey` request header.

## Path Parameters

| Parameter | Required | Description | Example |
|---|---|---|---|
| `asset_id` | Required |  | `000000000000000ea4f90001` |

## Response Fields

An array of objects:

| Field | Type | Description |
|---|---|---|
| `id` | string |  |
| `check_date` | string | date-time |

## Response Schema

_Inferred from examples._ Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract. The response body is an array; `[]` marks its elements.

| Field | Type |
|---|---|
| `[].id` | string |
| `[].check_date` | string |

## Examples

### 200 · OK

```bash
curl 'https://api.deepinfo.com/v1/easm/assets/000000000000000ea4f90001/whois-history' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'
```

`Content-Type: application/json` · `deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001`

```json
[
  {
    "id": "00000000000000000000000ebd470001",
    "check_date": "2025-07-31T08:00:00Z"
  },
  {
    "id": "00000000000000000000000ebd470002",
    "check_date": "2025-07-30T08:00:00Z"
  }
]
```

### 404 · Not Found (nonexistent asset_id)

```bash
curl 'https://api.deepinfo.com/v1/easm/assets/ffffffffffffffffffffffff/whois-history' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'
```

`Content-Type: application/json` · `deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001`

```json
{
  "code": 30003,
  "details": [
    "Asset not exists."
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}
```
