Expense Type Config

List all expense type definitions with metadata, formulas, and compatibility matrix

{
  "data": [
    {
      "id": "kilometers",
      "label": "Kilometers",
      "icon": "car",
      "category": "vehicle",
      "metadata": {
        "display_order": 1,
        "is_active": true,
        "requires_receipt": false,
        "unit": "km"
      },
      "formula": {
        "type": "per_unit",
        "rate": 0.5,
        "currency": "EUR",
        "unit": "km",
        "description": "€0.50 per kilometer driven"
      },
      "compatible_with": [
        "tolls",
        "parking"
      ],
      "incompatible_with": [
        "publicTransit"
      ]
    },
    {
      "id": "publicTransit",
      "label": "Public Transit",
      "icon": "train",
      "category": "transit",
      "metadata": {
        "display_order": 4,
        "is_active": true,
        "requires_receipt": true,
        "unit": "trip"
      },
      "formula": {
        "type": "reimbursed_at_cost",
        "currency": "EUR",
        "description": "Reimbursed at actual cost with receipt"
      },
      "compatible_with": [],
      "incompatible_with": [
        "kilometers",
        "tolls",
        "parking"
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 4
  }
}

Get full configuration for a specific expense type

{
  "id": "parking",
  "label": "Parking",
  "icon": "parking",
  "category": "vehicle",
  "metadata": {
    "display_order": 3,
    "is_active": true,
    "requires_receipt": true,
    "unit": "hours"
  },
  "formula": {
    "type": "per_unit",
    "rate": null,
    "currency": "EUR",
    "unit": "hours",
    "description": "Reimbursed at actual hourly rate with receipt"
  },
  "compatible_with": [
    "kilometers",
    "tolls"
  ],
  "incompatible_with": [
    "publicTransit"
  ]
}

Create a new expense type definition (admin only)

{
  "id": "ferry",
  "label": "Ferry",
  "icon": "anchor",
  "category": "transit",
  "metadata": {
    "display_order": 5,
    "is_active": true,
    "requires_receipt": true,
    "unit": "trip"
  },
  "formula": {
    "type": "reimbursed_at_cost",
    "currency": "EUR",
    "description": "Reimbursed at actual ticket cost with receipt"
  },
  "compatible_with": [
    "parking"
  ],
  "incompatible_with": [
    "publicTransit"
  ]
}

{
  "id": "ferry",
  "label": "Ferry",
  "icon": "anchor",
  "category": "transit",
  "metadata": {
    "display_order": 5,
    "is_active": true,
    "requires_receipt": true,
    "unit": "trip"
  },
  "formula": {
    "type": "reimbursed_at_cost",
    "currency": "EUR",
    "description": "Reimbursed at actual ticket cost with receipt"
  },
  "compatible_with": [
    "parking"
  ],
  "incompatible_with": [
    "publicTransit"
  ],
  "created_at": "2026-03-26T16:00:00Z"
}

Update expense type configuration (e.g. rate change, compatibility update)

{
  "formula": {
    "type": "per_unit",
    "rate": 0.55,
    "currency": "EUR",
    "unit": "km",
    "description": "€0.55 per kilometer driven (updated rate 2026)"
  }
}

{
  "id": "kilometers",
  "label": "Kilometers",
  "icon": "car",
  "category": "vehicle",
  "metadata": {
    "display_order": 1,
    "is_active": true,
    "requires_receipt": false,
    "unit": "km"
  },
  "formula": {
    "type": "per_unit",
    "rate": 0.55,
    "currency": "EUR",
    "unit": "km",
    "description": "€0.55 per kilometer driven (updated rate 2026)"
  },
  "compatible_with": [
    "tolls",
    "parking"
  ],
  "incompatible_with": [
    "publicTransit"
  ],
  "updated_at": "2026-03-26T16:30:00Z"
}

Deactivate or remove an expense type definition (admin only)

{
  "success": true,
  "deleted_id": "ferry"
}

Get the full compatibility matrix across all expense types

{
  "matrix": {
    "kilometers": {
      "tolls": true,
      "parking": true,
      "publicTransit": false
    },
    "tolls": {
      "kilometers": true,
      "parking": true,
      "publicTransit": false
    },
    "parking": {
      "kilometers": true,
      "tolls": true,
      "publicTransit": false
    },
    "publicTransit": {
      "kilometers": false,
      "tolls": false,
      "parking": false
    }
  },
  "generated_at": "2026-03-26T16:00:00Z"
}

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