Skip to main content

List Doctor Tests (v1)

Method & Path​

GET /api/v1/doctors/tests

Actual backend path: /v1/doctors/tests

Description​

List all lab tests assigned to the authenticated doctor across all workspaces. Doctors are global entities and can view tests from any workspace where they are assigned.

Authentication​

Required: Bearer token in Authorization header

Required Permissions:

  • Doctor authentication

Headers​

HeaderTypeRequiredDescription
AuthorizationstringYesBearer token: Bearer <token>

Path Parameters​

None

Query Parameters​

None (all tests for the doctor are returned; client-side filtering may be applied)

Request Body​

No request body required.

Response 200 OK​

{
"tests": [
{
"id": "507f1f77bcf86cd799439015",
"workspaceId": "507f1f77bcf86cd799439012",
"clientId": "507f1f77bcf86cd799439016",
"clientName": "John Doe",
"supervisorEmployeeId": "507f1f77bcf86cd799439017",
"supervisorName": "Dr. Smith",
"doctorId": "507f1f77bcf86cd799439018",
"doctorName": "Dr. Johnson",
"testDate": "2024-01-15T10:00:00Z",
"status": "pending",
"customFieldsJson": {
"sampleId": "SAMPLE-001"
},
"notes": "Follow-up required",
"invoiceId": null,
"incomeEntryId": null,
"postedAt": null,
"items": [
{
"id": "507f1f77bcf86cd799439020",
"testId": "507f1f77bcf86cd799439015",
"analysisId": "507f1f77bcf86cd799439011",
"analysisName": "Complete Blood Count",
"priceSnapshot": 150,
"unitSnapshot": "mg/dL",
"resultType": "numeric",
"resultValueNumeric": null,
"resultValueText": null,
"matchedRangeId": null,
"computedFlag": "unknown",
"resultNotes": [],
"aiInterpretation": null,
"aiInterpretedAt": null,
"createdAt": "2024-01-15T10:00:00Z",
"updatedAt": "2024-01-15T10:00:00Z"
}
],
"createdAt": "2024-01-15T10:00:00Z",
"updatedAt": "2024-01-15T10:00:00Z"
}
]
}

Common Errors​

  • 401 Unauthorized: Missing or invalid authentication token
  • 500 Internal Server Error: Server error