API Reference

Get expenses with filtering

get
https://open-api.guesty.com/v1/expenses-api/expenses

Retrieves expenses with optional filtering and pagination.

Filters by status (comma-separated), category, vendor, owner, listing, reservation IDs, and date ranges.

Returns up to 100 items per page. Defaults to 50 items, sorted by creation date descending.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum

Comma-separated expense statuses to filter by. Valid values: scheduled, submitted, insufficient_funds, paid, canceled

Allowed:
string

Category ID to filter expenses by

string

Vendor ID to filter expenses by (MongoDB ObjectId)

string

Owner ID to filter expenses by (MongoDB ObjectId)

string

Listing ID to filter expenses by (MongoDB ObjectId)

string

Reservation ID to filter expenses by (MongoDB ObjectId)

string

Expense Rule ID to filter expenses by

string

Filter expenses from this date (inclusive, ISO date format)

string

Filter expenses to this date (inclusive, ISO date format)

number
1 to 100
Defaults to 50

Number of expenses to return (1-100)

number
≥ 0
Defaults to 0

Number of expenses to skip for pagination

string
enum

Field to sort expenses by

Allowed:
string
enum

Sort order for the results

Allowed:
Responses

Updated 2 days ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 days ago