# Asset Instant Open Port Scan

Runs a port scan of the asset right away and returns the result in the response (status is host_down if the host did not respond).

Source: https://docs.deepinfo.com/reference/easm/asset-instant-open-port-scan/

Last updated: 2026-09-27

---
`POST https://api.deepinfo.com/v1/easm/assets/{asset_id}/open-ports/instant-scan`

Runs a port scan of the asset right away and returns the result in the response (`status` is `host_down` if the host did not respond).

## Authentication

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

## Path Parameters

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

## Response Fields

| Field | Type | Description |
|---|---|---|
| `target` | string |  |
| `check_date` | string | date-time |
| `status` | string |  |
| `target_ip` | string |  |
| `port_data` | object |  |
| `os` | array of string |  |

## 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 |
|---|---|
| `target` | string |
| `check_date` | string |
| `status` | string |
| `target_ip` | null |
| `port_data` | null |
| `os` | null |

## Examples

### 200 · OK

```bash
curl -X POST 'https://api.deepinfo.com/v1/easm/assets/000000000000000ea4f90001/open-ports/instant-scan' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'
```

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

```json
{
  "target": "acme.example",
  "check_date": "2025-07-31T08:00:00Z",
  "status": "host_down",
  "target_ip": null,
  "port_data": null,
  "os": null
}
```

### 404 · Not Found (nonexistent asset_id)

```bash
curl -X POST 'https://api.deepinfo.com/v1/easm/assets/ffffffffffffffffffffffff/open-ports/instant-scan' \
  -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/"
}
```