Expense Type Analytics Tracker

List recorded analytics events for expense type interactions

{
  "data": [
    {
      "id": "evt-001",
      "event_type": "type_selected",
      "expense_type": "kilometers",
      "session_id": "sess-abc123",
      "user_id": "usr-447",
      "occurred_at": "2026-03-26T09:15:22Z",
      "flushed": true
    },
    {
      "id": "evt-002",
      "event_type": "exclusion_triggered",
      "trigger_type": "kilometers",
      "disabled_types": [
        "publicTransit"
      ],
      "session_id": "sess-abc123",
      "user_id": "usr-447",
      "occurred_at": "2026-03-26T09:15:22Z",
      "flushed": true
    },
    {
      "id": "evt-003",
      "event_type": "validation_error",
      "error_message": "Cannot combine publicTransit with kilometers",
      "session_id": "sess-abc124",
      "user_id": "usr-448",
      "occurred_at": "2026-03-26T10:05:00Z",
      "flushed": false
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 3
  }
}

Get a specific analytics event by ID

{
  "id": "evt-002",
  "event_type": "exclusion_triggered",
  "trigger_type": "kilometers",
  "disabled_types": [
    "publicTransit"
  ],
  "session_id": "sess-abc123",
  "user_id": "usr-447",
  "occurred_at": "2026-03-26T09:15:22Z",
  "flushed": true
}

Track a new expense type analytics event

{
  "event_type": "type_selected",
  "expense_type": "parking",
  "session_id": "sess-abc125",
  "user_id": "usr-449",
  "occurred_at": "2026-03-26T14:00:00Z"
}

{
  "id": "evt-004",
  "event_type": "type_selected",
  "expense_type": "parking",
  "session_id": "sess-abc125",
  "user_id": "usr-449",
  "occurred_at": "2026-03-26T14:00:00Z",
  "flushed": false
}

Update or annotate an analytics event (e.g. mark flushed)

{
  "flushed": true
}

{
  "id": "evt-004",
  "event_type": "type_selected",
  "expense_type": "parking",
  "session_id": "sess-abc125",
  "user_id": "usr-449",
  "occurred_at": "2026-03-26T14:00:00Z",
  "flushed": true,
  "flushed_at": "2026-03-26T14:05:00Z"
}

Delete an analytics event record

{
  "success": true,
  "deleted_id": "evt-004"
}

Flush all pending (unflushed) events to the analytics pipeline

{
  "session_id": "sess-abc125"
}

{
  "flushed_count": 3,
  "failed_count": 0,
  "flushed_event_ids": [
    "evt-003",
    "evt-004",
    "evt-005"
  ],
  "flushed_at": "2026-03-26T14:10:00Z"
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}