UU App Analytics Documentation

Swagger Reference

Use the interactive Swagger UI for request/response schemas, authentication, and machine-readable OpenAPI metadata.

Open Swagger UI OpenAPI JSON

Admin API

Admin routes accept HTTP Basic auth or Authorization: Bearer <ADMIN_TOKEN>.

SSO browser sessions require an Analytics user invite. Standard users are scoped to apps owned by their SSO account owner ID; users with user_type superuser can manage all apps and users.

GET /api/apps lists apps. POST /api/apps creates an app with name and bundleId.

POST /api/apps/:id/api-clients creates an app-scoped token. The full token is returned once.

App Analytics Upload

Use an app token with analytics:write.

POST /api/analytics/app
Authorization: Bearer <APP_TOKEN>
Content-Type: application/json

{
  "bundleId": "com.example.app",
  "uniqueId": "install-or-device-id",
  "osVersion": "iOS 18.5",
  "appVersion": "1.2.3",
  "buildNumber": "456",
  "date": "2026-06-15T12:00:00Z",
  "deviceType": "iPhone17,1"
}

Raw unique IDs are hashed before storage. Device identifiers are enriched with readable Apple model names when known.

Generic Events

POST /api/analytics/events
Authorization: Bearer <APP_TOKEN>
Content-Type: application/json

{
  "eventType": "screen.view",
  "uniqueId": "install-or-device-id",
  "properties": {
    "screen": "home"
  }
}

Stats And Export

GET /api/apps/:id/stats returns aggregate stats for the app.

GET /api/apps/:id/events?limit=100 returns recent normalized events for export/debugging.

GET /admin/apps/:id/manage shows the same data in the admin UI.