# Asset Port Scan History Detail

GET /easm/assets/{asset_id}/port-scan-history/{history_id}: Returns one port scan snapshot of an asset, by the history_id returned by the list endpoint.

Source: https://docs.deepinfo.com/reference/easm/asset-port-scan-history-detail/

Last updated: 2026-09-27

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

Returns one port scan snapshot of an asset, by the `history_id` returned by the list endpoint.

## Authentication

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

## Path Parameters

| Parameter | Required | Description | Example |
|---|---|---|---|
| `asset_id` | Required |  | `000000000000000ea4f90001` |
| `history_id` | Required |  | `00000000000000000000000ebd470001` |

## Response Fields

| Field | Type | Description |
|---|---|---|
| `result` | object |  |
| `status` | boolean |  |
| `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.

| Field | Type |
|---|---|
| `result` | object |
| `result.status` | string |
| `result.target` | string |
| `result.target_ip` | string |
| `result.check_date` | string |
| `result.port_data` | object |
| `result.port_data.tcp` | array<object> |
| `result.port_data.tcp[].port_number` | number |
| `result.port_data.tcp[].service_name` | string |
| `result.port_data.tcp[].service_product` | null |
| `result.port_data.tcp[].service_version` | null |
| `result.port_data.tcp[].state` | string |
| `result.port_data.tcp[].extra_data` | object |
| `result.port_data.udp` | array |
| `result.os` | array |
| `status` | boolean |
| `check_date` | string |

## Examples

### 200 · OK

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

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

```json
{
  "result": {
    "status": "success",
    "target": "acme.example",
    "target_ip": "192.0.2.10",
    "check_date": "2025-07-31T08:00:00Z",
    "port_data": {
      "tcp": [
        {
          "port_number": 443,
          "service_name": "ftp-data",
          "service_product": null,
          "service_version": null,
          "state": "filtered",
          "extra_data": {}
        },
        {
          "port_number": 80,
          "service_name": "ftp",
          "service_product": null,
          "service_version": null,
          "state": "filtered",
          "extra_data": {}
        }
      ],
      "udp": []
    },
    "os": []
  },
  "status": true,
  "check_date": "2025-07-31T08:00:00Z"
}
```

### 404 · Not Found (nonexistent asset_id)

```bash
curl 'https://api.deepinfo.com/v1/easm/assets/ffffffffffffffffffffffff/port-scan-history/ffffffffffffffffffffffff' \
  -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 does not exist."
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}
```