Skip to main content

Verify Patient OTP (v1)

Method & Path​

POST /api/v1/public/labs/patient-otp/verify

Description​

Verify the OTP sent to the patient, return lab results grouped by workspace, and issue a session token for refresh.

Authentication​

None: Public endpoint. Persona access: Customer (patient).

Headers​

  • Content-Type: application/json

Request Body​

{
  "phone": "+972592123456",
  "otpCode": "123456"
}

Response 200 OK​

{
  "workspaces": [
    {
      "workspace": {
        "id": "66f0cbdc0c0f0a0a0a0a0a0a",
        "name": "Placio Lab"
      },
      "clients": [
        {
          "id": "66f0cbe50c0f0a0a0a0a0a0b",
          "name": "Patient Name"
        }
      ],
      "labVisits": [
        {
          "id": "66f0cc000c0f0a0a0a0a0a0c",
          "clientId": "66f0cbe50c0f0a0a0a0a0a0b",
          "labVisitDate": "2024-11-23T10:00:00.000Z",
          "labVisitStatus": "results-entered",
          "labTestSnapshots": [
            { "test": { "testTitle": "CBC", "testId": 101 } }
          ],
          "labTestResults": [
            { "testId": 101, "nodeResults": { "hb": 13.5 } }
          ]
        }
      ]
    }
  ],
  "sessionToken": "eyJhbGciOi..."
}

Common Errors​

  • 400 Bad Request: Missing phone/OTP or invalid OTP.
  • 404 Not Found: No OTP request found.
  • 422 Unprocessable Entity: Too many verification attempts or expired OTP.
  • 500 Internal Server Error: Unexpected server error.