Get all transactions

Use this endpoint to retrieve all transactions between a date range.

get
Get all transactions

https://dev.lunchmoney.app/v1/transactions
Returns list of Transaction objects. If no query parameters are set, this endpoint will return transactions for the current calendar month (see start_date and end_date)
Request
Response
Request
Query Parameters
tag_id
optional
number
Filter by tag. Only accepts IDs, not names.
recurring_id
optional
number
Filter by recurring expense
plaid_account_id
optional
number
Filter by Plaid account
category_id
optional
number
Filter by category. Will also match category groups.
asset_id
optional
number
Filter by asset
offset
optional
number
Sets the offset for the records returned
limit
optional
number
Sets the maximum number of records to return. Note: the server will not respond with any indication that there are more records to be returned. Please check the response length to determine if you should make another call with an offset to fetch more transactions.
start_date
optional
string
Denotes the beginning of the time period to fetch transactions for. Defaults to beginning of current month. Required if end_date exists.
end_date
optional
string
Denotes the end of the time period you'd like to get transactions for. Defaults to end of current month. Required if start_date exists.
debit_as_negative
optional
boolean
Pass in true if you’d like expenses to be returned as negative amounts and credits as positive amounts. Defaults to false.
Response
200: OK
Returns a list of transactions.
{ transactions:
[ { id: 602,
date: '2020-01-01',
payee: 'Starbucks',
amount: '4.5000',
currency: 'cad',
notes: 'Frappuccino',
category_id: null,
recurring_id: null,
asset_id: null,
plaid_account_id: null,
status: 'cleared',
is_group: false,
group_id: null,
parent_id: null,
external_id: null },
{ id: 603,
date: '2020-01-02',
payee: 'Walmart',
amount: '20.9100',
currency: 'usd',
notes: null,
category_id: null,
recurring_id: null,
asset_id: 153,
plaid_account_id: null,
status: 'uncleared',
is_group: false,
group_id: null,
parent_id: null,
external_id: 'jf2r3t98o943' } ] }
404: Not Found
Errors will be returned in parameters are invalid.
{ error: 'Both start_date and end_date must be specified.' }
{ error: 'Invalid start_date. Must be in format YYYY-MM-DD' }
{ error: 'Invalid end_date. Must be in format YYYY-MM-DD' }
{ error: 'end_date cannot be same or before start_date' }