---
title: "Track Ios Events"
method: POST
path: "/api/sdk/v1/track/ios"
tags: ["SDK"]
---

# Track Ios Events

`POST /api/sdk/v1/track/ios`

## Request

- Base URL: `https://geo.sig.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://geo.sig.ai/api/sdk/v1/track/ios`
- Auth: none declared

Track events from iOS SDK (accepts iOS SDK native format).
Transforms iOS SDK format to backend format and processes asynchronously.
Full URL: /api/sdk/v1/track/ios

## Headers

- `X-API-Key` string

## Request body

- IOSEventBatch: iOS SDK event batch.
  - `events` IOSEventPayload[], required
    - `eventId` string, required
    - `eventType` string, required
    - `eventName` string, required
    - `timestamp` string, date-time, required
    - `properties` object, nullable
    - `attribution` IOSAttributionPayload: iOS SDK attribution payload.
      - `source` string, required
      - `confidence` number, required
      - `method` string, required
      - `detectedAt` string, date-time, required
    - `deviceInfo` IOSDeviceInfo: iOS SDK device information.
      - `manufacturer` string, required
      - `model` string, required
      - `os` string, required
      - `osVersion` string, required
      - `deviceId` string, required
      - `locale` string, required
      - `timezone` string, required
      - `screenWidth` integer, required
      - `screenHeight` integer, required
    - `appInfo` IOSAppInfo: iOS SDK application information.
      - `bundleId` string, required
      - `version` string, required
      - `build` string, required
      - `name` string, required
    - `userId` string, nullable
    - `userProperties` object, nullable
    - `sessionId` string, required
  - `sentAt` string, date-time, required
  - `sdkVersion` string, required

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api.md) · [All operations](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/revisions/3ec39f9be9e0?raw)