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

# List Assets

> List monitored assets in your tenant scope

Returns assets available to the API key.

## Query Parameters

| Parameter | Type   | Required | Description                                                 |
| --------- | ------ | -------- | ----------------------------------------------------------- |
| `status`  | string | No       | Filter by asset status, for example `active`                |
| `type`    | string | No       | Filter by asset type, for example `facility` or `residence` |

## Response

```json theme={null}
{
  "assets": [
    {
      "id": "9b6d94f3-c8f1-4693-bf17-9d2bf54a3d7e",
      "assetId": "lagos-hq",
      "type": "facility",
      "name": "Lagos HQ",
      "role": "head_office",
      "status": "active",
      "attributes": {
        "lat": 6.4541,
        "lng": 3.3947,
        "address": "Victoria Island, Lagos",
        "country": "NG",
        "monitoringRadiusKm": 12
      },
      "threatConfig": {
        "enabled": true,
        "lookbackDays": 30
      },
      "physicalThreatConfig": {
        "enabled": true
      },
      "createdAt": "2026-04-18T10:00:00Z",
      "updatedAt": "2026-04-18T10:00:00Z"
    }
  ]
}
```

## Example Request

```bash theme={null}
curl -H "X-API-Key: your-api-key" "https://api.intrace.ai/v1/assets?type=facility&status=active"
```


## OpenAPI

````yaml get /v1/assets
openapi: 3.1.0
info:
  title: Intrace Events Monitoring API
  version: 0.1.0
  description: >
    External asset monitoring and event intelligence API derived from the
    internal

    Intrace events investigations platform.


    This public API is tenant-scoped by API key and intentionally does not
    expose

    internal identifiers such as case_id or investigation_id.
servers:
  - url: https://api.intrace.ai
security:
  - ApiKeyAuth: []
tags:
  - name: Assets
  - name: Threats
  - name: Incidents
  - name: Alerts
  - name: Reports
  - name: Event Intelligence
paths:
  /v1/assets:
    get:
      tags:
        - Assets
      summary: List assets
      operationId: listAssets
      parameters:
        - name: status
          in: query
          schema:
            type: string
        - name: type
          in: query
          schema:
            type: string
            enum:
              - facility
              - residence
      responses:
        '200':
          description: Asset list.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetListResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
components:
  schemas:
    AssetListResponse:
      type: object
      properties:
        assets:
          type: array
          items:
            $ref: '#/components/schemas/Asset'
      required:
        - assets
    Asset:
      type: object
      properties:
        id:
          type: string
          format: uuid
        asset_id:
          type: string
        type:
          type: string
        name:
          type: string
        role:
          type: string
          nullable: true
        status:
          type: string
        attributes:
          $ref: '#/components/schemas/AssetAttributes'
        threat_config:
          $ref: '#/components/schemas/ThreatConfig'
        physical_threat_config:
          $ref: '#/components/schemas/PhysicalThreatConfig'
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - id
        - asset_id
        - type
        - name
        - status
        - created_at
        - updated_at
    AssetAttributes:
      type: object
      additionalProperties: true
      properties:
        lat:
          type: number
        lng:
          type: number
        address:
          type: string
        country:
          type: string
        monitoring_radius_km:
          type: number
    ThreatConfig:
      type: object
      additionalProperties: false
      properties:
        enabled:
          type: boolean
          default: true
        alert_classes:
          type: array
          items:
            type: string
            enum:
              - class_1_situational_awareness
              - class_2_potential_threat
              - class_3_direct_threat
        custom_instructions:
          type: string
        monitored_event_types:
          type: array
          items:
            type: string
        lookback_days:
          type: integer
          minimum: 1
          maximum: 90
    PhysicalThreatConfig:
      type: object
      additionalProperties: false
      properties:
        enabled:
          type: boolean
          default: true
        alert_classes:
          type: array
          items:
            type: string
            enum:
              - class_1_situational_awareness
              - class_2_potential_threat
              - class_3_direct_threat
        custom_instructions:
          type: string
        monitored_event_types:
          type: array
          items:
            type: string
        max_age_hours_by_category:
          type: object
          additionalProperties:
            type: integer
  responses:
    Unauthorized:
      description: Missing or invalid API key.
    Forbidden:
      description: Authenticated but not allowed for this tenant scope.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````