---
title: "Track page events"
method: POST
path: "/track"
tags: ["Tracking"]
---

# Track page events

`POST /track`

## Request

- Base URL: `http://localhost:4000`
- URL: `http://localhost:4000/track`
- Auth: none declared

Batch insert page view / interaction events. Accepts a single event object or an array of up to 50 events. Client IP and user-agent are captured automatically.

## Request body

- union
  - TrackEventRequest: Single page event
    - `eventType` string: Event type (e.g. page_view, click). Aliased as `event`.
    - `path` string: Page path
    - `element` string: UI element identifier
    - `metadata` object: Arbitrary metadata
    - `sessionId` string: Client session ID
  - TrackEventsBatchRequest: Batch of page events (max 50)
    - `events` TrackEventRequest[]
      - `eventType` string: Event type (e.g. page_view, click). Aliased as `event`.
      - `path` string: Page path
      - `element` string: UI element identifier
      - `metadata` object: Arbitrary metadata
      - `sessionId` string: Client session ID

## Response `200`

Events recorded

- TrackResponse
  - `ok` boolean
  - `count` integer: Number of events recorded

## Other responses

- `400`: No events provided

---

[API](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api.md) · [All operations](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reqistry/apis/public-apis-mobile-client-api/revisions/7f07b9ca718f?raw)