User Billable Rates

Admin permissions required.

List all billable rates for a specific user

Returns a list of billable rates for the user identified by USER_ID. The billable rates are returned sorted by start_date, with the oldest starting billable rates appearing first.

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

Link to documentation

hrvst users billable-rates list-by-user

Option	Description	Required
--user_id	The ID of the user whose billable rates you're listing.	true
--page	The page number to use in pagination. Use all to retrieve all pages.	false
--per_page	The number of records to return per page. Can range between 1 and 2000.	false
--fields	Comma separated list of fields to display in the output.	false
--output	The output format: json, table	false

Retrieve a specific billable rate

Retrieves the billable rate with the given ID. Returns a billable rate object and a 200 OK response code if a valid identifier was provided.

Link to documentation

hrvst users billable-rates get

Option	Description	Required
--user_id	The ID of the user whose billable rate you're retrieving.	true
--billable_rate_id	The ID of the billable rate you're retrieving.	true
--fields	Comma separated list of fields to display in the output.	false
--output	The output format: json, table	false

Create a billable rate

Creates a new billable rate object. Returns a billable rate object and a 201 Created response code if the call succeeded.

• Creating a billable rate with no start_date will replace a user’s existing rate(s).
• Creating a billable rate with a start_date that is before a user’s existing rate(s) will replace those billable rates with the new one.

Link to documentation

hrvst users billable-rates create

Option	Description	Required
--user_id	The ID of the user that you're creating a billable rate for.	true
--amount	The amount of the billable rate.	true
--start_date	The date the billable rate is effective. Cannot be a date in the future.	false
--fields	Comma separated list of fields to display in the output.	false
--output	The output format: json, table	false