Skip to main content
GET
/
api
/
v1
/
expense-reports
Expense Reports
curl --request GET \
  --url https://api.example.com/api/v1/expense-reports
{
  "year": 2025,
  "totalAmount": 450000,
  "totalCount": 23,
  "topCategory": "travel",
  "categoryDistribution": [
    { "category": "travel", "label": "Travel", "amount": 180000 },
    { "category": "meals", "label": "Meals", "amount": 95000 },
    { "category": "licensing", "label": "Licensing", "amount": 75000 }
  ],
  "months": [
    {
      "month": 1,
      "name": "January",
      "total": 120000,
      "count": 8,
      "expenses": [
        {
          "id": 1,
          "category": "travel",
          "amount": 4500,
          "date": "2025-01-15",
          "description": "Gas",
          "receiptKey": "receipts/1/abc123.jpg"
        }
      ]
    }
  ],
  "assignmentGroups": [
    {
      "assignmentId": 1,
      "facility": "Memorial Hospital",
      "total": 300000,
      "count": 15,
      "expenses": []
    }
  ]
}
Returns expenses grouped by month and by assignment for the given year, with category distribution and summary stats.

​
Query Parameters

​
year
string
default:"current year"
Tax year (YYYY format).

​
Response

{
  "year": 2025,
  "totalAmount": 450000,
  "totalCount": 23,
  "topCategory": "travel",
  "categoryDistribution": [
    { "category": "travel", "label": "Travel", "amount": 180000 },
    { "category": "meals", "label": "Meals", "amount": 95000 },
    { "category": "licensing", "label": "Licensing", "amount": 75000 }
  ],
  "months": [
    {
      "month": 1,
      "name": "January",
      "total": 120000,
      "count": 8,
      "expenses": [
        {
          "id": 1,
          "category": "travel",
          "amount": 4500,
          "date": "2025-01-15",
          "description": "Gas",
          "receiptKey": "receipts/1/abc123.jpg"
        }
      ]
    }
  ],
  "assignmentGroups": [
    {
      "assignmentId": 1,
      "facility": "Memorial Hospital",
      "total": 300000,
      "count": 15,
      "expenses": []
    }
  ]
}