Expense Form BLoC

List in-progress form sessions for a user

{
  "data": [
    {
      "session_id": "sess_b4d2f9",
      "user_id": "usr_88f3a1",
      "activity_id": "act_3b81fa",
      "state": "awaiting_receipt",
      "last_updated": "2026-03-18T09:08:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}

Get current form session state

{
  "session_id": "sess_b4d2f9",
  "user_id": "usr_88f3a1",
  "activity_id": "act_3b81fa",
  "selected_expense_types": [
    "travel_distance",
    "parking"
  ],
  "amount": 247.5,
  "distance_km": 42,
  "has_receipt": false,
  "state": "awaiting_receipt",
  "validation_errors": [
    "Receipt required for parking amounts over 200 NOK"
  ],
  "last_updated": "2026-03-18T09:08:00Z"
}

Start a new expense form session

{
  "user_id": "usr_88f3a1",
  "activity_id": "act_3b81fa",
  "organization_id": "org_4729bc"
}

{
  "session_id": "sess_b4d2f9",
  "user_id": "usr_88f3a1",
  "activity_id": "act_3b81fa",
  "organization_id": "org_4729bc",
  "state": "selecting_expense_types",
  "created_at": "2026-03-18T08:55:00Z"
}

Update form state (expense type selection, amount, distance, receipt flag)

{
  "event": "AmountChanged",
  "selected_expense_types": [
    "travel_distance",
    "parking"
  ],
  "amount": 247.5,
  "distance_km": 42,
  "has_receipt": false
}

{
  "session_id": "sess_b4d2f9",
  "selected_expense_types": [
    "travel_distance",
    "parking"
  ],
  "amount": 247.5,
  "distance_km": 42,
  "has_receipt": false,
  "state": "awaiting_receipt",
  "validation_errors": [
    "Receipt required for parking amounts over 200 NOK"
  ],
  "last_updated": "2026-03-18T09:08:00Z"
}

Discard form session (user cancelled)

{
  "deleted": true,
  "session_id": "sess_b4d2f9"
}

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