Bulk-fetch bids by ID

POST

/bids/get-many

• Production

Fetch up to 50 bids by ID in a single round-trip. Returns flat bid rows only (no line items / sublines / distributed costs — call GET /bids/{id} per id for the full tree). IDs that don’t exist are silently omitted; compare meta.requested vs meta.returned to detect missing.

Authorizations

• bearerAuth
  bids:read

Request Body

object

ids

required

Array<integer>

>= 1 items <= 50 items

Responses

200

Bids

object

data

required

Array<object>

object

id

required

integer

bidNumber

required

string

contactId

required

integer | null

leadId

required

integer | null

projectId

required

integer | null

status

required

string

subtotal

required

string | null

taxAmount

required

string | null

total

required

string | null

taxRate

required

string | null

discount

required

string | null

discountType

required

string | null

validUntil

required

Any of:

string

string format: date-time

string

string

null

null

notes

required

string | null

terms

required

string | null

siteAddress

required

string | null

sentAt

required

Any of:

string

string format: date-time

string

string

null

null

acceptedAt

required

Any of:

string

string format: date-time

string

string

null

null

acceptedBy

required

string | 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

Error

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

Error

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