Skip to main content

Expense Categories

Information pertaining to retrieving, created, editing, and deleting expense categories.

Link to documentation

List all expense categories

Returns a list of your expense categories. The expense categories are returned sorted by creation date, with the most recently created expense categories appearing first.

The response contains an object with a expense_categories property that contains an array of up to per_page expense categories. Each entry in the array is a separate expense category object. If no more expense categories are available, the resulting array will be empty. Several additional pagination properties are included in the response to simplify paginating your expense categories.

Link to documentation

hrvst expenses categories list
OptionDescriptionRequired
--is_activePass true to only return active expense categories and false to return inactive expense categories.false
--update_sinceOnly return expense categories that have been updated since the given date and time.false
--pageThe page number to use in pagination. Use all to retrieve all pages.false
--per_pageThe number of records to return per page. Can range between 1 and 2000.false
--fieldsComma separated list of fields to display in the output.false
--outputThe output format: json, tablefalse

Retrieve a specific expense category

Retrieves the company for the currently authenticated user. Returns a company object and a 200 OK response code.

Link to documentation

hrvst expenses categories get
OptionDescriptionRequired
--expense_category_idThe ID of the expense category you're retrieving.true
--fieldsComma separated list of fields to display in the output.false
--outputThe output format: json, tablefalse

Create an expense category

Retrieves the company for the currently authenticated user. Returns a company object and a 200 OK response code.

Link to documentation

hrvst expenses categories create
OptionDescriptionRequired
--nameThe name of the expense category.true
--unit_nameThe unit name of the expense category.false
--unit_priceThe unit price of the expense category.false
--is_activeWhether the expense category is active or archived.false
--fieldsComma separated list of fields to display in the output.false
--outputThe output format: json, tablefalse

Update an expense category

Updates the specific expense category by setting the values of the parameters passed. Any parameters not provided will be left unchanged. Returns an expense category object and a 200 OK response code if the call succeeded.

Link to documentation

hrvst expenses categories update
OptionDescriptionRequired
--expense_category_idThe ID of the expense category you're updating.true
--nameThe name of the expense category.false
--unit_nameThe unit name of the expense category.false
--unit_priceThe unit price of the expense category.false
--is_activeWhether the expense category is active or archived.false
--fieldsComma separated list of fields to display in the output.false
--outputThe output format: json, tablefalse

Delete an expense category

Delete an expense category. Returns a 200 OK response code if the call succeeded.

Link to documentation

hrvst expenses categories delete
OptionDescriptionRequired
--expense_category_idThe ID of the expense category you're retrieving.true
--fieldsComma separated list of fields to display in the output.false
--outputThe output format: json, tablefalse