Actions77
- Columns Actions
- Comments Actions
- Companies Actions
- Currencies Actions
- Document Anchors Actions
- List Document Anchor
- List Basket Document Anchor
- Count Basket Document Anchor
- Check Edited Document Anchor
- Get By Id Document Anchor
- Update Document Anchor
- Delete Document Anchor
- Get Versions Document Anchor
- Get History Document Anchor
- Rotate Document Anchor
- Split Document Anchor
- Reassign Document Anchor
- Reassign All Document Anchor
- Redetect Document Anchor
- Get File Document Anchor
- Get Symbolic Links Document Anchor
- Get Group Treatments Document Anchor
- Get Group Documents Document Anchor
- Count Without Template Document Anchor
- List Without Template Document Anchor
- Set Template Document Anchor
- Transition Document Anchor
- Get State Document Anchor
- Update State Document Anchor
- Annotations Actions
- Expenses Actions
- Expense Categories Actions
- Expense Projects Actions
- Expense Reports Actions
- External Attachments Actions
- Fields Actions
- Files Actions
- Groups Actions
- Pending Transaction Actions
- Taxes Actions
- Tax Groups Actions
- Templates Actions
- Template Types Actions
- Streams Actions
- Users Actions
- Viridem Actions
Expenses → List Expense
AI-generatedOverview
This node operation lists expenses for a specified company with various filtering and pagination options. It is useful for retrieving expense records based on criteria such as date range, status, user, and ordering preferences. For example, a user can list all expenses for a company within a specific date range, filter by expense status, and paginate through the results.
Use Case Examples
- List all expenses for company ID 123 ordered by date descending.
- Retrieve expenses with status 'approved' or 'pending' for a specific user within a date range.
- Paginate through expenses 15 items per page for company ID 456.
Properties
| Name | Meaning |
|---|---|
| Company Id | The ID of the company for which to list expenses. This is a required numeric input. |
| Order By Date | The order in which to sort the expenses by date, e.g., ascending or descending. |
| Status In | Filter expenses by their status, allowing multiple statuses to be specified as a JSON array. |
| Start Date | The start date to filter expenses from (inclusive). |
| End Date | The end date to filter expenses to (inclusive). |
| User Id | Filter expenses by a specific user ID. |
| Page | The page number for paginated results. |
| Per Page | The number of expense items to return per page. |
Output
JSON
expenses- An array of expense objects matching the filter criteria.paginationpage- The current page number of the results.per_page- The number of items returned per page.total_pages- The total number of pages available.total_items- The total number of expense items matching the criteria.
Dependencies
- An API key credential for authentication with the Viridem API.
Troubleshooting
- Ensure the Company Id is provided and valid, as it is required for the request.
- Check that date filters (Start Date and End Date) are in the correct format if used.
- Verify that the status filter is a valid JSON array if used.
- If pagination parameters (Page and Per Page) are set, ensure they are positive integers.
- If the API returns errors related to authentication, verify the API key credential is correctly configured.