Returns a list of time entries.

GET /psa/time-entries

Group: PSA › Time Entries · Operation ID: timeEntries

Returns time entries for the projects where you are a team member.

The person and project identifiers on each entry (memberId, memberEmployeeId, projectPositionId and psaProjectId) are returned but cannot be filtered or sorted on. There is no endpoint that lists a specific employee's time entries.

Open in the interactive reference

Parameters

Name	In	Type	Required	Description
`Api-Version`	header	`"v1"`	yes	The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version `v1`.

Query surface

id — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
date — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
currency — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
submissionStatus — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
submissionDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
month — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
projectActivityId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
lastModifiedDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
Orderable: id, date, month, hours, submissionStatus, submissionDate, currency, lastModifiedDate
Selectable: id, date, hours, billableHours, nonBillableHours, internalValuableHours, internalNonValuableHours, invoicedHours, revenue, cost, currency, notes, submissionStatus, submissionDate, month, memberId, memberEmployeeId, memberEmployeeName, projectActivityId, projectActivityName, projectActivityCategory, projectPositionId, projectPositionName, psaProjectId, projectName, psaProjectStatus, lastModifiedDate

Response

200 Success

Under data, an array of timeEntriesRow:

Field	Type	Required	Description
`id`	string	no	The unique identifier for the time entry.
`date`	string (date) or null	no	The date the time was logged for. Format YYYY-MM-DD.
`hours`	string (decimal) or null	no	The total hours logged in this entry.
`billableHours`	string (decimal) or null	no	The hours classified as billable to a customer, derived from projectActivityCategory.
`nonBillableHours`	string (decimal) or null	no	The hours classified as non-billable to a customer, derived from projectActivityCategory.
`internalValuableHours`	string (decimal) or null	no	The hours classified as internal valuable work, derived from projectActivityCategory.
`internalNonValuableHours`	string (decimal) or null	no	The hours classified as internal non-valuable work, derived from projectActivityCategory.
`invoicedHours`	string (decimal) or null	no	The hours that have been invoiced, a subset of billableHours.
`revenue`	string (decimal) or null	no	The revenue from this time entry, in the currency given by currency.
`cost`	string (decimal) or null	no	The cost of this time entry, in the currency given by currency.
`currency`	string or null	no	The currency of revenue and cost. Format ISO 4217, for example 'USD'. It is the currency of the project position's bill rate.
`notes`	string or null	no	Free-form notes on the time entry.
`submissionStatus`	string or null	no	The submission and approval status of the entry. Possible values: 'draft', 'pending', 'approved', 'rejected', 'invoiced'.
`submissionDate`	string (date) or null	no	The date the entry was submitted for approval. Format YYYY-MM-DD.
`month`	string (date) or null	no	The first day of the month the entry is reported under. Format YYYY-MM-DD.
`memberId`	number or null	no	The numeric key of the PSA member assignment the time was logged for. GET psa/team-members/:id takes the member's UUID, not this key, so it cannot fetch the member.
`memberEmployeeId`	number or null	no	The numeric key of the employee who logged the time. There is no endpoint for it.
`memberEmployeeName`	string or null	no	The name of the employee who logged the time.
`projectActivityId`	number or null	no	The numeric key of the activity the time was logged against. GET psa/activities/:id takes the activity's UUID, not this key, so it cannot fetch the activity.
`projectActivityName`	string or null	no	The name of the activity the time was logged against.
`projectActivityCategory`	string or null	no	The billability category of the activity the time was logged against. The billable, non-billable and internal-hour fields are derived from it. See category on GET psa/activities/:id.
`projectPositionId`	number or null	no	The numeric key of the position the time was logged against. GET psa/positions/:id takes the position's UUID, not this key, so it cannot fetch the position.
`projectPositionName`	string or null	no	The name of the position the time was logged against.
`psaProjectId`	number or null	no	The numeric key of the PSA project the entry belongs to. GET psa/projects/:id takes the project's UUID, not this key, so it cannot fetch the project.
`projectName`	string or null	no	The name of the PSA project the entry belongs to.
`psaProjectStatus`	string or null	no	The status of the PSA project this entry belongs to.
`lastModifiedDate`	string (date-time) or null	no	The date and time the entry last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ.

Statuses

400 — Invalid request or business failure
401 — Missing or invalid access token
403 — Not authorized
404 — Not found
429 — Too many requests
500 — Internal server error