Skip to main content
GET
/
v4
/
expenses
/
categories
Get categories
curl --request GET \
  --url https://sandbox.hurdlr.com/rest/v4/expenses/categories \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 123,
    "name": "Accounting / Tax",
    "taxCategory": {
      "id": "<string>",
      "name": "<string>",
      "displayName": "<string>",
      "taxCategorySchedC1040Name": "<string>",
      "taxCategory1065Name": "<string>",
      "taxCategoryT2125Name": "<string>",
      "form1040SchedCLineNumber": "<string>",
      "form1040SchedCDisplayName": "<string>",
      "t2125LineNumber": "<string>",
      "t2125DisplayName": "<string>",
      "form1065LineNumber": "<string>",
      "form1065DisplayName": "<string>",
      "form1120SLineNumber": "<string>",
      "form1120SDisplayName": "<string>",
      "entityId": 123
    },
    "hasChilds": true,
    "parentCategoryId": 123,
    "status": "ACTIVE"
  }
]

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
lastUpdatedDate
string

Date filter - returns all records updated after the specified date. Null returns all data

Response

200 - application/json

Successful operation

​
id
integer<int64>

Id of the category, required when updating existing category

​
name
string

Name of the business-specific expense category

Example:

"Accounting / Tax"

​
taxCategory
object
​
hasChilds
boolean

Whether this category has children or not

​
parentCategoryId
integer<int64>

Parent id for this category, if it exists

​
status
enum<string>

Status of this category

Available options:
ACTIVE,
INACTIVE,
DELETED
Example:

"ACTIVE"