Hours and earnings over a date range

Hours worked and money earned, billed and unbilled alike: the Reports page's numbers. Totals, one row per day/month/quarter/year, one per project, and the top tasks. Amounts are USD and priced from records: billed time is each entry's share of the invoice that billed it, time not invoiced yet is priced at its rate, time from before Tallymeter's own invoices (before records_from) at the rate it carried then. Finished entries only: a running timer counts once it stops. Requires the reports:read scope.

get/api/v1/reports/time

Request

  • Base URL: https://tallymeter.com
  • URL: https://tallymeter.com/api/v1/reports/time
  • Auth: HTTP bearer

Query parameters

fromstring date

Start date, YYYY-MM-DD in the user's timezone, inclusive. Defaults to the first day of to's month.

tostring date

End date, YYYY-MM-DD in the user's timezone, inclusive. Defaults to today.

bucket'day' | 'month' | 'quarter' | 'year'

Row size for periods. Defaults by span: day up to 45 days, month up to 3 years, year beyond.

tasksinteger

How many tasks to list in top_tasks, most hours first. Default 10.

Response

Hours and money for the range

fromstring date required
tostring date required
currency'USD' required
records_fromstring date nullable required

first day Tallymeter's own invoices cover; null until the workspace has one

bucket'day' | 'month' | 'quarter' | 'year' required

Changes

No recorded changes to this operation across all 1 revision of this API.