> ## 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.

# Heatmap Points

> Return lightweight heatmap points for large-scale rendering

Returns compact coordinate-plus-severity data optimized for map rendering.

## Response shape

```json theme={null}
{
  "points": [
    [3.39, 6.45, 2],
    [7.39, 9.07, 1]
  ],
  "total": 2
}
```

Severity weights:

* `0` = low
* `1` = medium
* `2` = high or critical


## OpenAPI

````yaml get /v1/events/heatmap-points
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/events/heatmap-points:
    get:
      tags:
        - Event Intelligence
      summary: Heatmap points
      operationId: heatmapPoints
      responses:
        '200':
          description: Lightweight heatmap payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HeatmapPointsResponse'
components:
  schemas:
    HeatmapPointsResponse:
      type: object
      properties:
        points:
          type: array
          items:
            type: array
            prefixItems:
              - type: number
              - type: number
              - type: integer
            minItems: 3
            maxItems: 3
        total:
          type: integer
      required:
        - points
        - total
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````