Bulk-fetch projects by ID

POST

/projects/get-many

• Production

Fetch up to 50 projects by ID in a single round-trip. Returns flat project rows only (no phases / tasks / contacts). IDs that don’t exist are silently omitted; compare meta.requested vs meta.returned to detect missing.

Authorizations

• bearerAuth
  projects:read

Request Body

object

ids

required

Array<integer>

>= 1 items <= 50 items

Responses

200

Projects

object

data

required

Array<object>

object

id

required

integer

name

required

string

projectNumber

required

string

contactId

required

integer | null

bidId

required

integer | null

projectType

required

string | null

status

required

string

priority

required

string | null

startDate

required

Any of:

string

string format: date-time

string

string

null

null

expectedEndDate

required

Any of:

string

string format: date-time

string

string

null

null

actualEndDate

required

Any of:

string

string format: date-time

string

string

null

null

contractValue

required

string | null

description

required

string | null

siteAddress

required

string | null

assignedTo

required

integer | null

createdAt

required

Any of:

string

string format: date-time

string

string

updatedAt

required

Any of:

string

string format: date-time

string

string

meta

required

object

request_id

Server-generated request identifier

string

pagination

object

cursor

required

Opaque cursor for the next page; null when no more results

string | null

has_more

required

Whether more pages are available after this one

boolean

count

required

Items in this page

integer

requested

required

integer

returned

required

integer

403

Scope insufficient

object

type

required

URL identifying the problem type

string format: uri

title

required

Short human-readable summary

string

status

required

HTTP status code

integer

detail

Human-readable explanation

string

request_id

Server-generated request identifier

string

errors

Validation error array (422 only)

Array<object>

object

field

required

Field path that failed validation

string

code

required

Validation error code

string

message

required

Human-readable validation message

string

422

Validation failed

object

type

required

URL identifying the problem type

string format: uri

title

required

Short human-readable summary

string

status

required

HTTP status code

integer

detail

Human-readable explanation

string

request_id

Server-generated request identifier

string

errors

Validation error array (422 only)

Array<object>

object

field

required

Field path that failed validation

string

code

required

Validation error code

string

message

required

Human-readable validation message

string