API RESOURCE

ラボ

Create lab orders and track their status end to end; manage partner laboratories. Spot delays early.

Endpoints

7 endpoint

Endpoints for this resource. Every endpoint is scoped to the clinic data the API key is bound to; write endpoints support the Idempotency-Key header.

GET /v1/lab-orders Lists lab orders Authorized user

POST /v1/lab-orders Creates a lab order Authorized user

GET /v1/lab-orders/{id} Retrieves order details Authorized user

PUT /v1/lab-orders/{id} Updates the order Authorized user

POST /v1/lab-orders/{id}/status Changes the order status Authorized user

GET /v1/labs Lists partner laboratories Authorized user

POST /v1/labs Adds a laboratory Authorized user

Example Usage

Create a lab order

Request

curl -X POST https://api.udentiva.com/v1/lab-orders \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"patient_id":"c0ffee00-...","lab_id":"lab-3","type":"crown"}'

Response

HTTP/1.1 201 Created
{
  "id": "lo-204",
  "status": "created",
  "created_at": "2026-06-24T09:25:00Z"
}

Security in this resource

Security isn't a feature, it's the architecture itself. The guarantees that apply to this resource:

Lab orders and laboratory records are isolated to your clinic (RLS).

State transitions are performed via action endpoints and recorded in the audit log.

Full security model →

Error Format

Errors are returned in a consistent envelope; the code is for the machine, the message for the user. Internal error/stack is never leaked.

{
  "error": {
    "code": "validation_failed",
    "message": "Invalid field: email"
  }
}

Other Resources

患者予約とカレンダー Odontogram & Treatment Collections & Finance 在庫 Imaging Lead & CRM 医療ツーリズム Reporting & BI Webhooks Data Transfer (Export API)

Want early access?

Be the first to know when the API opens.

お問い合わせ