List expenses
GET
apiKeyheader
AuthorizationBearer <token>An API key (blk_…) from Settings → API keys.
page?integerRange
1 <= value <= 100000Default
1pageSize?integerRange
1 <= value <= 100Default
25sort?stringMatch
^[A-Za-z]+:(asc|desc)$from?stringMatch
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$Format
dateto?stringMatch
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$Format
datecategoryId?stringMatch
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Format
uuidclientId?stringMatch
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Format
uuidprojectId?stringMatch
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Format
uuidbilling?stringValue in
"billable""unbilled""non_billable"q?stringLength
length <= 100application/json- response
items*array<>total*integerRange
-9007199254740991 <= value <= 9007199254740991page*integerRange
-9007199254740991 <= value <= 9007199254740991pageSize*integerRange
-9007199254740991 <= value <= 9007199254740991totals*array<>curl -X GET 'https://your-billleaf-api/v1/expenses'Example Response200
{ "items": [ { "id": "string", "spentOn": "2019-08-24", "vendor": "string", "description": "string", "categoryId": "string", "categoryName": "string", "amount": -9007199254740991, "taxAmount": -9007199254740991, "currency": "string", "paymentMethod": "bank_transfer", "reference": "string", "clientId": "string", "clientName": "string", "projectId": "string", "projectName": "string", "billable": true, "invoiceId": "string", "invoiceNumber": "string", "receipt": { "filename": "string", "contentType": "string", "url": "string" }, "createdAt": "2019-08-24T14:15:22Z" } ], "total": -9007199254740991, "page": -9007199254740991, "pageSize": -9007199254740991, "totals": [ { "currency": "string", "amount": -9007199254740991 } ]}