Driver Honorarium Service - API Contract

GET /api/v1/honorariums/api/v1/honorariums

List honorariums for a period and organization

Public

Response Example

{
  "data": [
    {
      "honorarium_id": "hon_4e7b2a",
      "expense_id": "exp_9c2d7e",
      "claimant_id": "usr_88f3a1",
      "amount": 150,
      "currency": "NOK",
      "declaration_acknowledged": true,
      "created_at": "2026-03-18T08:58:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}

GET /api/v1/honorariums/api/v1/honorariums/:id

Get honorarium by ID

Public

Response Example

{
  "honorarium_id": "hon_4e7b2a",
  "expense_id": "exp_9c2d7e",
  "claimant_id": "usr_88f3a1",
  "organization_id": "org_4729bc",
  "amount": 150,
  "currency": "NOK",
  "declaration_acknowledged": true,
  "declaration_acknowledged_at": "2026-03-18T08:57:00Z",
  "created_at": "2026-03-18T08:58:00Z",
  "updated_at": "2026-03-18T08:58:00Z"
}

POST /api/v1/honorariums/api/v1/honorariums

Save a driver honorarium declaration

Public

Request Example

{
  "expense_id": "exp_9c2d7e",
  "amount": 150,
  "currency": "NOK",
  "declaration_acknowledged": true
}

Response Example

{
  "honorarium_id": "hon_4e7b2a",
  "expense_id": "exp_9c2d7e",
  "amount": 150,
  "currency": "NOK",
  "declaration_acknowledged": true,
  "declaration_acknowledged_at": "2026-03-18T08:57:00Z",
  "created_at": "2026-03-18T08:58:00Z"
}

PUT /api/v1/honorariums/api/v1/honorariums/:id

Update honorarium amount or re-acknowledge declaration

Public

Request Example

{
  "amount": 175,
  "declaration_acknowledged": true
}

Response Example

{
  "honorarium_id": "hon_4e7b2a",
  "amount": 175,
  "declaration_acknowledged": true,
  "updated_at": "2026-03-18T09:05:00Z"
}

DELETE /api/v1/honorariums/api/v1/honorariums/:id

Delete honorarium (draft expense only)

Public

Response Example

{
  "deleted": true,
  "honorarium_id": "hon_4e7b2a"
}

GET /api/v1/honorariums/api/v1/honorariums/by-expense/:expenseId

Get honorarium linked to a specific expense

Public

Response Example

{
  "honorarium_id": "hon_4e7b2a",
  "expense_id": "exp_9c2d7e",
  "amount": 150,
  "currency": "NOK",
  "declaration_acknowledged": true
}

GET /api/v1/honorariums/api/v1/honorariums/eligibility

Check if an activity type is eligible for driver honorarium

Public

Response Example

{
  "activity_type": "youth_training",
  "eligible": true,
  "reason": "Youth training activities qualify for driver honorarium under clause 4.2"
}

Additional Metadata

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