Skip to main content

Get Holiday (v1)

Method & Path​

GET /api/v1/workspace/:workspaceId/holidays/:holidayId

Description​

Retrieve a specific holiday by ID.

Authentication​

Required: Workspace authentication. User must be authenticated as Workspace Owner or Staff with workspace permissions.

Headers​

Authorization: Bearer <workspace_token>
Content-Type: application/json

Path Parameters​

ParameterTypeRequiredDescription
workspaceIdstringYesWorkspace identifier
holidayIdstringYesHoliday identifier

Response 200 OK​

{
  "holiday": {
    "id": "507f1f77bcf86cd799439011",
    "workspaceId": "507f1f77bcf86cd799439012",
    "name": "New Year's Day",
    "date": "2025-01-01T00:00:00.000Z",
    "isRecurring": false,
    "recurrenceRule": null,
    "createdAt": "2024-12-01T10:00:00.000Z",
    "updatedAt": "2024-12-01T10:00:00.000Z"
  }
}

Response Fields​

See List Holidays for field descriptions.

Common Errors​

401 Unauthorized: Missing or invalid authentication token

403 Forbidden: User does not have permission to view holidays

404 Not Found: Workspace or holiday not found

500 Internal Server Error: Server error occurred while processing the request