Skip to main content
GET
/
api
/
v1
/
expenses
List Expenses
curl --request GET \
  --url https://api.example.com/api/v1/expenses
[
  {
    "id": 1,
    "user_id": 1,
    "assignment_id": 1,
    "category": "travel",
    "amount": 4500,
    "date": "2025-02-15",
    "description": "Gas station fill-up",
    "receipt_s3_key": "receipts/1/abc123.jpg",
    "created_at": "2025-02-15T14:30:00.000Z"
  }
]
Returns a paginated list of expenses, optionally filtered by year or assignment.

​
Query Parameters

​
year
string
Filter by year (YYYY format).
​
assignment_id
integer
Filter by linked assignment ID.
​
limit
integer
default:"100"
Maximum records to return (1–200).
​
offset
integer
default:"0"
Number of records to skip.

​
Response

Returns an array of expense objects with X-Total-Count header. 
[
  {
    "id": 1,
    "user_id": 1,
    "assignment_id": 1,
    "category": "travel",
    "amount": 4500,
    "date": "2025-02-15",
    "description": "Gas station fill-up",
    "receipt_s3_key": "receipts/1/abc123.jpg",
    "created_at": "2025-02-15T14:30:00.000Z"
  }
]