Skip to main content

Get Test Group (v1)

Method & Path

GET /api/v1/workspace/:workspaceId/labs/test-groups/:testGroupId

Actual backend path: /v1/workspace/:workspaceId/labs/test-groups/:testGroupId

Description

Get a single test group by ID.

Authentication

Required: JWT token in Authorization header

Required Permissions:

  • labs.view

Headers

HeaderTypeRequiredDescription
AuthorizationstringYesBearer token: Bearer <token>

Path Parameters

ParameterTypeRequiredDescription
workspaceIdstringYesWorkspace identifier (MongoDB ObjectId)
testGroupIdstringYesTest group identifier (MongoDB ObjectId)

Response 200 OK

{
"testGroup": {
"id": "507f1f77bcf86cd799439011",
"workspaceId": "507f1f77bcf86cd799439012",
"testGroupId": 5196,
"testGroupTitle": "Liver Functions+",
"testGroupDefaultPrice": 17.14,
"testGroupAccountId": 382,
"deletedAt": null,
"createdAt": "2024-01-15T10:00:00Z",
"updatedAt": "2024-01-15T10:00:00Z"
}
}

Common Errors

  • 401 Unauthorized: Missing or invalid authentication token
  • 403 Forbidden: Insufficient permissions (requires labs.view)
  • 404 Not Found: Workspace or test group not found
  • 500 Internal Server Error: Server error