List positions

Operation ID: psaPositions

Group: PSA › Positions

Open in the interactive reference

GET /psa/positions

Read-only: Reads and returns; changes nothing.

Lists positions. The psaProjectId and the other reference ids on a position are numeric ids, not UUIDs, so you can't use them to read the project or any other record they point to.

Positions can't be filtered by name or description, and there is no search endpoint for positions.

Parameters

Name In Type Required Description
Api-Version header string · 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

Response

200 Success

Under data, an array of psaPositionsRow:

Field Type Required Filter Sort Description
id string no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) yes The unique identifier for the position. Example: "7c2e91a4-58fd-4b30-9e17-3a6d05fb824c".
psaProjectId number no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) yes The id of the PSA project this position belongs to. It is a numeric key, not the UUID that GET psa/projects/:id takes. Example: 32341.
name string | null no no no The display name of the position. Example: "Senior Consultant".
description string | null no no no A free-form description of the position's responsibilities. Example: "Leads the delivery workstream on site.".
salesOrderProductLineId number | null no no no The id of the sales order product line this position fulfills. It is a numeric key. There is no endpoint for it.
salesOrderProductLineRateCardEntryId number | null no no no The id of the sales order product line rate card entry used for billing. It is a numeric key. There is no endpoint for it.
productId number | null no no no The id of the product this position is billed against. It is a numeric key, not the UUID that GET accounting/products/:id takes.
productLineId number | null no no no The id of the product line this position is billed against. It is a numeric key, not the UUID that GET accounting/product-lines/:id takes.
productLineRateCardEntryId number | null no no no The id of the product line rate card entry. It is a numeric key. There is no endpoint for it.
billable boolean | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) no Whether work in this position is billable to the customer. Example: true.
unitOfMeasure string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) yes The unit the stored bill rate, cost rate and budget are expressed in. It is a member of the UnitOfMeasureType enum, in practice 'hour' or 'day' for a position, with 'hour' the default. Example: "hour".
hourlyBillRate decimal | null no no no The bill rate for this position, as an hourly amount, in the currency given by hourlyBillRateCurrency. Example: "185.00".
hourlyBillRateCurrency string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no The currency of hourlyBillRate. Format ISO 4217, for example 'USD'. Example: "USD".
hourlyCostRate decimal | null no no no The cost rate for this position, as an hourly amount, in the currency given by hourlyCostRateCurrency. Example: "110.00".
hourlyCostRateCurrency string | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) no The currency of hourlyCostRate. Format ISO 4217, for example 'USD'. Example: "USD".
hoursBudget decimal | null no no no The budgeted hours for this position. It is a quantity in hours and has no currency. Example: "120.00".
invoiced boolean | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) no Whether work in this position has been invoiced. Example: false.
hrPositionId number | null no no no The id of the HR position this PSA position maps to. It is a numeric key, not the UUID that GET people/positions/:id takes.
skillLevelId number | null no no no The id of the skill level (position seniority) this PSA position maps to. It is a numeric key. There is no endpoint for it.
lastModifiedDate date-time | null no Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) yes The date and time the position record last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ. Example: "2026-08-14T11:20:31.004Z". 
{
  "data": [
    {
      "id": "7c2e91a4-58fd-4b30-9e17-3a6d05fb824c",
      "psaProjectId": 32341,
      "name": "Senior Consultant",
      "description": "Leads the delivery workstream on site.",
      "salesOrderProductLineId": 0,
      "salesOrderProductLineRateCardEntryId": 0,
      "productId": 0,
      "productLineId": 0,
      "productLineRateCardEntryId": 0,
      "billable": true,
      "unitOfMeasure": "hour",
      "hourlyBillRate": "185.00",
      "hourlyBillRateCurrency": "USD",
      "hourlyCostRate": "110.00",
      "hourlyCostRateCurrency": "USD",
      "hoursBudget": "120.00",
      "invoiced": false,
      "hrPositionId": 0,
      "skillLevelId": 0,
      "lastModifiedDate": "2026-08-14T11:20:31.004Z"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "<nextCursor>"
  }
}

Statuses