List Expenses

Returns Expenses for the organization.

GEThttps://api.tracksales.co/api/v1/expenses

Required scope: expenses:read

Query Params

searchstring

Search by name, code, or reference

location_idinteger

Filter by branch/location ID

expense_typestring

Filter by expense type

vendor_idinteger

Filter by vendor ID

payment_methodstring

Filter by payment method

limitinteger

Page size (default 20, max 1000)

offsetinteger

Pagination offset (default 0)

Responses

200OK

Request succeeded.

401Unauthorized

API key is missing or invalid.

403Forbidden

API key lacks the required scope.

404Not Found

Expenses was not found.

422Validation Error

Request validation failed.

curl -X GET 'https://api.tracksales.co/api/v1/expenses?limit=20&search=acme' \
  -H 'Authorization: Bearer ts_live_YOUR_API_KEY' \
  -H 'Accept: application/json'

{
    "success": true,
    "data": {
        "items": [
            {
                "expense_id": 15,
                "amount": 2500,
                "description": "Office supplies",
                "date": "2026-07-01"
            }
        ],
        "total": 1
    }
}

{
    "success": false,
    "error": {
        "code": "unauthenticated",
        "message": "Invalid or revoked API key."
    }
}

{
    "success": false,
    "error": {
        "code": "forbidden",
        "message": "API key lacks required scope."
    }
}

{
    "success": false,
    "message": "Expenses not found"
}

{
    "success": false,
    "message": "Validation failed",
    "errors": {
        "field": [
            "The field is required."
        ]
    }
}