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

# Resources and fields

> Reference of every Attack Surface Query resource: its fields, types, relations, and which fields can be filtered, sorted and grouped

Every row of every resource also has an `id` (filter with `eq`, `neq`, `in`, `notIn`). In the tables below, **Sort** and **Group** mark fields usable in `orderBy` and `groupBy`; operators per type are listed in [Filtering](https://docs.oasm.io/attack-surface-query/filtering.md#operators). A field that can be empty (`lastSeen`, `version`, `cvssScore`, most `http` and `tls` fields…) also takes `isNull` and `isNotNull`. `GET /api/attack-surface/schema` returns the same reference as JSON, with the exact operators of each field, limited to what you may read.

## targets

The scan roots of the workspace. Permission: `target.read`.

| Field | Type | Sort | Group | Description |
| - | - | :-: | :-: | - |
| `value` | text | ✓ | ✓ | Domain, IP, CIDR or organization URL |
| `type` | enum: `DOMAIN`, `CIDR`, `IP`, `GIT_ORG` | | ✓ | Target type |
| `firstSeen` | time | ✓ | bucket | When the target was added |

Lists: `hosts`.

## hosts

Domains, subdomains and IPs found under a target (and repositories of Git organization targets). Permission: `asset.read`.

| Field | Type | Sort | Group | Description |
| - | - | :-: | :-: | - |
| `value` | text | ✓ | ✓ | Host name, IP or repository |
| `kind` | enum: `domain`, `ip`, `repository` | | ✓ | What the host is |
| `isPrimary` | bool | | | The target's own host |
| `isEnabled` | bool | | | Disabled hosts are kept but not scanned |
| `firstSeen` | time | ✓ | bucket | When the host was first discovered |
| `lastSeen` | time | ✓ | bucket | When a scan last reported the host |
| `isNew` | bool | | | Found by the latest finished discovery run of its target |

Related: `target`. Lists: `services`, `ips`, `dnsRecords`, `vulnerabilities`.

## services

One open port of a host. Permission: `asset.read`.

| Field | Type | Sort | Group | Description |
| - | - | :-: | :-: | - |
| `value` | text | | | `host:port` |
| `port` | int | ✓ | ✓ | Port number |
| `isErrorPage` | bool | | | The last HTTP probe failed |
| `firstSeen` | time | ✓ | bucket | When the port was first found open |
| `lastSeen` | time | ✓ | bucket | When a scan last reported the port |
| `isNew` | bool | | | Found by the latest finished run of its workflow on the target |

Related: `host`, `target`, `http` (the latest HTTP response). Lists: `technologies`, `tls`, `statusCodes`, `urls`, `tags`.

### http (through `services.http`)

The service's latest HTTP probe. Read it with dot paths: `http.title`.

| Field | Type | Sort | Group | Description |
| - | - | :-: | :-: | - |
| `url` | text | | | Probed URL |
| `title` | text | ✓ | | Page title |
| `statusCode` | int | ✓ | ✓ | HTTP status code |
| `webserver` | text | | ✓ | `Server` header |
| `scheme` | text | | ✓ | `http` or `https` |
| `contentType` | text | | ✓ | `Content-Type` |
| `contentLength` | int | | | Body length |
| `faviconMd5` | text | | ✓ | Favicon hash, to find the same application on other hosts |
| `failed` | bool | | | The probe failed |
| `probedAt` | time | ✓ | | When the probe ran |
| `body`, `rawHeader`, `header` | text / JSON | | | Response body and headers; large, not available to the AI agent and not filterable when JSON |

### statusCodes and tags (lists of `services`)

| Resource | Field | Type | Description |
| - | - | - | - |
| `statusCodes` | `statusCode` | int | Status code of the response or of a redirect hop |
| | `isPrimary` | bool | `true` for the final status, `false` for a redirect hop |
| | `chainIndex` | int | Position in the redirect chain |
| `tags` | `tag` | text | A tag of the service |

## technologies

Technologies seen in each service's **latest** HTTP response. Permission: `asset.read`.

| Field | Type | Sort | Group | Description |
| - | - | :-: | :-: | - |
| `name` | text | ✓ | ✓ | Technology name |
| `version` | text | | ✓ | Version, when known |
| `firstSeen` | time | ✓ | bucket | When the response carrying it was recorded |

Related: `service`.

## tls

The TLS certificate of each service's **latest** HTTP response. Permission: `asset.read`.

| Field | Type | Sort | Group | Description |
| - | - | :-: | :-: | - |
| `host` | text | | | Host the certificate was served for |
| `port` | text | | | Port |
| `tlsVersion` | text | | ✓ | Negotiated TLS version |
| `cipher` | text | | ✓ | Negotiated cipher |
| `subjectCn` | text | | | Subject common name |
| `issuerCn` | text | | ✓ | Issuer common name |
| `notBefore` | time | | | Valid from |
| `notAfter` | time | ✓ | | Valid until |
| `daysToExpiry` | int | | | Days until `notAfter`, negative when expired |
| `wildcard` | bool | | | Wildcard certificate |
| `fingerprintSha256` | text | | | SHA-256 fingerprint |
| `firstSeen` | time | ✓ | bucket | When the certificate was recorded |

Related: `service`.

## urls

URLs discovered on services by crawling and URL discovery. Permission: `asset.read`.

| Field | Type | Sort | Group | Description |
| - | - | :-: | :-: | - |
| `url` | text | | | The URL |
| `firstSeen` | time | ✓ | bucket | When the URL was first discovered |
| `isNew` | bool | | | Found by the latest finished discovery run of its target |

Related: `service`.

## ips

IP addresses hosts resolve to, from their DNS A and AAAA records. Permission: `asset.read`.

| Field | Type | Sort | Group | Description |
| - | - | :-: | :-: | - |
| `ip` | ip | | ✓ | IP address (`inSubnet` takes CIDRs) |
| `source` | enum: `dns_a`, `dns_aaaa` | | ✓ | Record type it came from |
| `firstSeen` | time | ✓ | bucket | When the record was first seen |

Related: `host`.

## dnsRecords

DNS records of hosts. Permission: `asset.read`.

| Field | Type | Sort | Group | Description |
| - | - | :-: | :-: | - |
| `recordType` | text | | ✓ | `A`, `AAAA`, `CNAME`, `MX`, `TXT`… |
| `value` | text | | | Record value |
| `firstSeen` | time | ✓ | bucket | When the record was first seen |

Related: `host`.

## vulnerabilities

Approved findings. AI proposals under review or rejected never appear. Permission: `vulnerability.read`.

| Field | Type | Sort | Group | Description |
| - | - | :-: | :-: | - |
| `name` | text | | ✓ | Finding name |
| `severity` | enum: `info`, `low`, `medium`, `high`, `critical` | | ✓ | Severity |
| `cvssScore` | number | ✓ | | CVSS score |
| `epssScore` | number | ✓ | | EPSS score |
| `cve`, `cwe` | list of text | | | CVE and CWE ids |
| `tags` | list of text | | | Tags |
| `ports` | list of text | | | Affected ports |
| `affectedUrl` | text | | | Affected URL |
| `detectionStatus` | enum: `new`, `active`, `resurfaced`, `fixed` | | ✓ | Lifecycle state |
| `isOpen` | bool | | | Approved, still detected and not dismissed: the "open" count shown everywhere in OASM |
| `firstSeen` | time | ✓ | bucket | When the finding was first recorded |
| `lastSeen` | time | ✓ | | When a scan last reported it |
| `fixedAt` | time | | | When a covering scan closed it |

Related: `host`, `tool` (`tool.name`: the scanner that reported it). Details of one finding (description, proof of concept, remediation, evidence, timeline) are on the [vulnerability](https://docs.oasm.io/vulnerability.md) page and API, not in ASQ.

## rollups

Pre-computed counts of the workspace, refreshed every 15 minutes. Permission: `asset.read`. Not available inside a project.

| Field | Type | Sort | Group | Description |
| - | - | :-: | :-: | - |
| `metric` | enum: `port`, `technology`, `webserver`, `statusCode`, `tlsVersion` | | ✓ | Which distribution |
| `key` | text | | ✓ | The counted value, e.g. `443`, `nginx` |
| `value` | int | ✓ | | Count |
| `computedAt` | time | | | When it was refreshed |

See [Counting and grouping](https://docs.oasm.io/attack-surface-query/aggregations.md#rollups-instant-counts-for-large-workspaces).

## Projects

Inside a project — a project chat of the AI agent, or a `projectId` given to the agent tool — every resource except `rollups` is limited to the project's assets.


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