List reports
Reports with status, total, submitter and approver, newest first.
MCP tool expensify_read → list_reports
read
Lists reports you can see in a workspace, newest first, with total, currency, number of expenses and whether any expense is on hold. Filter by status to find what waits for you. Statuses are the ones Expensify shows: Draft, Submitted, Outstanding, Approved, Paid and Done.
Parameters
| Name | Type | Description |
|---|---|---|
| workspace string required | string | Workspace name or ID from list_workspaces, e.g. 'Acme Studio'. |
| status enum | enum | draft, submitted, outstanding, approved, paid or done. Default: all. |
| needs_my_approval boolean | boolean | Only reports waiting for your approval. Default: false. |
| since date | date | Only reports created on or after this date. |
| limit integer | integer | 1 to 100. Default: 25. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "expensify_read",
"arguments": {
"operation": "list_reports",
"arguments": {
"workspace": "Acme Studio"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"reports": [
{
"report_id": "R10077",
"title": "Week of 5 Oct",
"submitter": "Marcus Lee",
"status": "Submitted",
"total": 148.2,
"currency": "USD",
"expenses": 4,
"has_hold": false,
"created_at": "2026-10-09T16:02:00Z"
},
{
"report_id": "R10042",
"title": "Week of 12 Oct",
"submitter": "You",
"status": "Draft",
"total": 612.9,
"currency": "USD",
"expenses": 7,
"has_hold": true,
"created_at": "2026-10-13T09:15:00Z"
}
],
"next_cursor": null
},
"isError": false
}