Skip to main content
POST
Receive stock

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string
required

A unique value you choose for this request, such as a UUID. Sending the same key again returns the first answer instead of doing the work twice, so a timed-out request is safe to retry. Reusing a key for a different request is refused with 409 idempotency_key_conflict, and retrying while the first request is still running with 409 idempotency_key_reused. See Retries and idempotency.

Minimum string length: 1

Path Parameters

clinic_id
string<uuid>
required

Body

application/json
item_id
string<uuid>
required
location_id
string<uuid>
required
quantity
number
required
lot_number
string
expiry_date
string<date>

Required, and refused if in the past, for item_type IN (medication, vaccine, injectable) — regardless of the clinic's own setting.

unit_cost
number
vendor_id
string<uuid>
reference
string

Echoed back only — no column exists on inventory_transactions to persist it.

Response

OK.

data
object
required

The ledger movement receive/adjust/transfer just recorded — never the whole inventory_transactions row.