Skip to main content
List endpoints support offset-based pagination using limit and offset query parameters.

​
Parameters

ParameterTypeDefaultRangeDescription
limitinteger1001–200Maximum number of records to return
offsetinteger00+Number of records to skip

​
Total Count Header

List endpoints return an X-Total-Count header with the total number of matching records (before pagination). Use this to calculate the total number of pages. 
X-Total-Count: 47

​
Example

Fetch the second page of 20 expenses: 
curl -H "Authorization: Bearer <token>" \
  "https://app.taxhomebase.com/api/v1/expenses?limit=20&offset=20"
Response headers: 
X-Total-Count: 47
Response body: 
[
  { "id": 21, "category": "travel", "amount": 4500, ... },
  { "id": 22, "category": "meals", "amount": 1200, ... },
  ...
]

​
Calculating Pages

totalPages = Math.ceil(totalCount / limit)
currentPage = Math.floor(offset / limit) + 1

​
Endpoints with Pagination

The following endpoints support limit and offset:
  • GET /assignments
  • GET /expenses
  • GET /tax-home
  • GET /tax-home-docs
  • GET /tax-home-costs
  • GET /mileage
  • GET /credentials

​
Endpoints with Page-Based Pagination

The notifications endpoint uses page and limit instead of offset:
ParameterTypeDefaultRange
pageinteger11+
limitinteger201–50
curl -H "Authorization: Bearer <token>" \
  "https://app.taxhomebase.com/api/v1/notifications?page=2&limit=20"