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

# Get Event Tile

> Return a Mapbox vector tile for event rendering

Returns an MVT tile as `application/x-protobuf`.

## Path Parameters

| Parameter | Type    | Required | Description       |
| --------- | ------- | -------- | ----------------- |
| `z`       | integer | Yes      | Zoom level        |
| `x`       | integer | Yes      | Tile x coordinate |
| `y`       | integer | Yes      | Tile y coordinate |

## Query Parameters

| Parameter        | Type   | Required | Description                                            |
| ---------------- | ------ | -------- | ------------------------------------------------------ |
| `date_from`      | string | No       | Inclusive start date                                   |
| `date_to`        | string | No       | Inclusive end date                                     |
| `event_category` | string | No       | Filter by category                                     |
| `event_type`     | string | No       | Filter by type                                         |
| `layer`          | string | No       | Tile layer such as `heatmap`, `clustered`, or `detail` |

## Example Request

```bash theme={null}
curl -H "X-API-Key: your-api-key" "https://api.intrace.ai/v1/events/tiles/4/8/5.pbf?event_category=armed_conflict" --output tile.pbf
```


## OpenAPI

````yaml get /v1/events/tiles/{z}/{x}/{y}.pbf
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/tiles/{z}/{x}/{y}.pbf:
    get:
      tags:
        - Event Intelligence
      summary: Get event tile
      operationId: getEventTile
      parameters:
        - name: z
          in: path
          required: true
          schema:
            type: integer
            minimum: 0
            maximum: 22
        - name: x
          in: path
          required: true
          schema:
            type: integer
            minimum: 0
        - name: 'y'
          in: path
          required: true
          schema:
            type: integer
            minimum: 0
        - name: date_from
          in: query
          schema:
            type: string
            format: date
        - name: date_to
          in: query
          schema:
            type: string
            format: date
        - name: event_category
          in: query
          schema:
            type: string
        - name: event_type
          in: query
          schema:
            type: string
        - name: layer
          in: query
          schema:
            type: string
            enum:
              - heatmap
              - clustered
              - detail
      responses:
        '200':
          description: Vector tile.
          content:
            application/x-protobuf:
              schema:
                type: string
                format: binary
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````