Returns a list of the people on PSA project teams.

GET /psa/team-members

Group: PSA › Team Members · Operation ID: teamMembers

Each row is one person on a PSA project's team. To find who fills which position, use GET psa/team-member-positions. There is no endpoint to match a member by name.

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

psaProjectId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
employeeId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
isTeamLead — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
startDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
endDate — 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: psaProjectId, startDate, endDate, lastModifiedDate
Selectable: id, psaProjectId, employeeId, isTeamLead, startDate, endDate, allocation, name, displayName, lastModifiedDate

Response

200 Success

Under data, an array of teamMembersRow:

Field	Type	Required	Description
`id`	string	no	The unique identifier for the team-roster row.
`psaProjectId`	number	no	The id of the PSA project this record belongs to. It is a numeric package-layer key you can filter on here, not the UUID that GET psa/projects/:id takes.
`employeeId`	number or null	no	The id of the employee this roster row is for. It is a numeric package-layer key, not a UUID any public endpoint returns as a fetchable id.
`isTeamLead`	boolean or null	no	Whether this team member is the team lead.
`startDate`	string (date) or null	no	The first day of this person's membership of the team. Format YYYY-MM-DD. Absent when not set.
`endDate`	string (date) or null	no	The last day of this person's membership of the team. Format YYYY-MM-DD. Absent when not set.
`allocation`	string (decimal) or null	no	The share of the person's capacity allocated to this team, as a percentage. For example, 50 means 50%.
`name`	string or null	no	The full name of the team member. It is returned but cannot be filtered or sorted on, and there is no endpoint to find a member by name.
`displayName`	string or null	no	The preferred display name of the team member. Like name, it cannot be filtered or sorted on.
`lastModifiedDate`	string (date-time) or null	no	The date and time this roster row 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