Bulk-fetch products by ID

POST

/products/get-many

• Production

Fetch up to 50 products by ID in one round-trip. IDs that don’t exist or belong to another tenant are silently omitted — compare meta.requested to meta.returned to detect missing.

Authorizations

• bearerAuth
  products:read

Request Body

object

ids

required

Array<integer>

>= 1 items <= 50 items

Responses

200

Products

object

data

required

Array<object>

object

id

required

integer

sku

required

string

name

required

string

description

required

string | null

type

required

string

categoryId

required

integer | null

costPrice

required

string | null

sellPrice

required

string | null

unit

required

string | null

manufacturerId

required

integer | null

manufacturerCode

required

string | null

isKit

required

boolean

isActive

required

boolean

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