Assets

List Assets

GET /api/v1/assets

Returns all discovered assets across your organization. Optionally filter by domain or type.

curl -H "X-API-Key: sb_live_abc123def456" \
  "https://api.surfbot.io/api/v1/assets?domain_id=550e8400-e29b-41d4-a716-446655440000&type=subdomain"

Query Parameters:

Parameter	Type	Description
`domain_id`	string	Filter assets by domain UUID
`type`	string	Filter by asset type: `subdomain`, `ip`, `url`, `service`

Response (200):

{
  "assets": [
    {
      "id": "220e8400-e29b-41d4-a716-446655440000",
      "domain_id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "subdomain",
      "value": "api.example.com",
      "status": "active",
      "first_seen": "2026-01-01T00:00:00Z",
      "last_seen": "2026-03-15T10:17:30Z",
      "metadata": {
        "ips": ["93.184.216.34"],
        "ports": [80, 443]
      }
    }
  ],
  "count": 1
}

List Domain Assets

GET /api/v1/domains/:id/assets

Shortcut to list assets filtered by a specific domain.

curl -H "X-API-Key: sb_live_abc123def456" \
  https://api.surfbot.io/api/v1/domains/550e8400-e29b-41d4-a716-446655440000/assets

Same response format as List Assets.

Get Asset

GET /api/v1/assets/:id

Returns a single asset with its metadata.

curl -H "X-API-Key: sb_live_abc123def456" \
  https://api.surfbot.io/api/v1/assets/220e8400-e29b-41d4-a716-446655440000

Response (200):

{
  "id": "220e8400-e29b-41d4-a716-446655440000",
  "domain_id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "subdomain",
  "value": "api.example.com",
  "status": "active",
  "first_seen": "2026-01-01T00:00:00Z",
  "last_seen": "2026-03-15T10:17:30Z",
  "metadata": {
    "ips": ["93.184.216.34"],
    "ports": [80, 443],
    "technologies": ["nginx/1.24.0", "Node.js"]
  }
}

Asset types: subdomain, ip, url, service, port, technology, dns_record, certificate, email, cloud_resource

Asset statuses: active, inactive, new

List Assets

List Domain Assets

Get Asset

On this page