Skip to content

Create lab result

Creates a new lab result.

Note: This endpoint requires a user-scoped OAuth token. A pure client_credentials token without user context will be rejected.

Request

POST /api/oauth/v2/resource/lab-results

HeaderValue
AuthorizationBearer {access_token}
Content-Typeapplication/json

Body parameters

FieldTypeRequiredDescription
customerUuidstringYesUUID of the assigned customer
namestringNoName of the lab result
textstringNoDescription text
resultTextstringNoResult text
notestringNoInternal note
deviationstringNoDeviation from the norm value
unitstringNoUnit of measurement
normRangestringNoNormal range
warningbooleanNoWarning active
datestringNoDate of the lab result (YYYY-MM-DD, default: today)
bloodSamplingDatestringNoDate of blood sampling (YYYY-MM-DD)
evidenceNumberstringNoEvidence number
titlestringNoTitle (default: "Labor")
shortTitlestringNoShort title (default: "Lab")

Response

Success (201 Created)

json
{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Complete blood count",
    "text": "Routine check before surgery",
    "resultText": "All values within normal range",
    "note": "Patient arrived fasting",
    "deviation": null,
    "unit": null,
    "normRange": null,
    "warning": false,
    "date": "2026-06-09",
    "bloodSamplingDate": "2026-06-09",
    "evidenceNumber": "LB-2026-00123",
    "title": "Labor",
    "shortTitle": "Lab",
    "customer": {
      "id": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
      "firstName": "Anna",
      "lastName": "Muster"
    }
  }
}

Response fields

See Get lab result for the full field description.

Beispiele
bash
curl -X POST "https://my.offisy.at/api/oauth/v2/resource/lab-results" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "customerUuid": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
    "name": "Muster GmbH",
    "text": "beispiel",
    "resultText": "beispiel",
    "note": "beispiel",
    "deviation": "beispiel",
    "unit": "beispiel",
    "normRange": "beispiel",
    "warning": "beispiel",
    "date": "2026-04-15T10:00:00",
    "bloodSamplingDate": "2026-04-15T10:00:00",
    "evidenceNumber": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
    "title": "beispiel",
    "shortTitle": "beispiel"
  }'
Parameter
Zuerst Token anfordern

Possible errors

StatusCodeDescription
400validation_errorInvalid request data (e.g. customerUuid missing)
401invalid_clientInvalid or missing access token
403insufficient_scopeScope medicals not present
404not_foundCustomer not found

Offisy GmbH