Mileage Calculation Service

List recent calculations (audit log). Returns paginated log of calculation events.

{
  "data": [
    {
      "id": "calc_01HXQR8C3Z",
      "user_id": "usr_abc123",
      "distance_km": 42.5,
      "rate_per_km": 0.45,
      "raw_amount": 19.125,
      "rounded_amount": 19.13,
      "locale": "en-IE",
      "formatted_amount": "€19.13",
      "calculated_at": "2026-03-25T14:29:58Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}

Fetch a single calculation record by ID.

{
  "id": "calc_01HXQR8C3Z",
  "user_id": "usr_abc123",
  "distance_km": 42.5,
  "rate_per_km": 0.45,
  "raw_amount": 19.125,
  "rounded_amount": 19.13,
  "locale": "en-IE",
  "formatted_amount": "€19.13",
  "calculated_at": "2026-03-25T14:29:58Z"
}

Compute reimbursement amount for given distance and rate. Returns raw, rounded, and locale-formatted values. Stateless — does not persist a claim.

{
  "distance_km": 42.5,
  "rate_per_km": 0.45,
  "locale": "en-IE"
}

{
  "distance_km": 42.5,
  "rate_per_km": 0.45,
  "raw_amount": 19.125,
  "rounded_amount": 19.13,
  "locale": "en-IE",
  "formatted_amount": "€19.13"
}

Recompute a saved calculation with updated parameters (e.g. corrected distance or rate).

{
  "distance_km": 45,
  "rate_per_km": 0.45,
  "locale": "en-IE"
}

{
  "id": "calc_01HXQR8C3Z",
  "distance_km": 45,
  "rate_per_km": 0.45,
  "raw_amount": 20.25,
  "rounded_amount": 20.25,
  "locale": "en-IE",
  "formatted_amount": "€20.25",
  "calculated_at": "2026-03-25T15:10:00Z"
}

Remove a calculation audit record.

{
  "id": "calc_01HXQR8C3Z",
  "deleted": true,
  "deleted_at": "2026-03-25T16:00:00Z"
}

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