Skip to main contentRecent updates
November 11, 2025 - New Inductions API endpoints
We’ve added new endpoints to help you integrate with BuildPass induction data:
Inductions API
New endpoints for accessing induction records:
-
GET /subcontractors/<id>/inductions - Get all inductions for workers associated with a subcontractor
- Filter by project ID, status, and type
- Supports pagination with offset/limit
- Returns induction details including type, status, worker, subcontractor
-
GET /builders/<builderId>/projects/<projectId>/inductions - Get all inductions for a project
- Filter by status
- Supports pagination with offset/limit
- Returns induction details including type, status, and worker information
-
GET /builders/<builderId>/projects/<projectId>/inductions/<identifierOrId> - Get a specific induction
- Supports lookup by project-specific identifier (e.g.
5) or induction ID (e.g. ind_abc123)
- Automatically returns latest version when version history exists
- Returns full induction details with worker, subcontractor, project, and responses
These endpoints require the read:inductions scope and follow the same authentication patterns as other API endpoints.
January 15, 2025 - Subcontractor endpoints improvements
Enhanced performance and reliability for subcontractor status data:
-
GET /subcontractors - List subcontractors
- Subcontractor statuses are now properly filtered based on the
projectId query parameter when provided
- Fixed an issue that caused duplicate statuses to appear in responses
-
GET /subcontractors/<id> - Get subcontractor
- Added support for the
projectId query parameter to retrieve project-specific status information
June 25, 2025 - OAuth 2.0 authentication enhancements
We’ve enhanced our authentication system to more effectively comply with the OAuth 2.0 standards:
New features
- HTTP Basic Authentication: You can now authenticate using HTTP Basic Authentication in addition to the existing request body method
- Pass client credentials via the
Authorization: Basic <credentials> header
- Credentials should be Base64-encoded in the format
client_id:client_secret
- Request body credentials take precedence when both methods are used
Changes
- Standardized Token Expiration: The
expires field has been renamed to expires_in. The value of this field has not changed.
- Enhanced Security: Improved request validation and error handling.
Migration guide
You must ensure your code properly handles the expires_in field. This can be used to determine when a new token is necessary. The expires field will be maintained until the 25th of September, 2025.
May 26th, 2025 - New API endpoints
Timesheets API
We’ve added comprehensive timesheet management endpoints to help you integrate with BuildPass timesheet data:
-
GET /timesheets - Retrieve all timesheets for a builder with filtering options
- Filter by project, status, and date range
- Supports pagination with offset/limit
- Returns timesheet details including hours, notes, time types, and cost codes
-
GET /timesheets/<timesheetId> - Get a specific timesheet by ID
- Includes associated profile and project information
- Full timesheet details with approval status
-
GET /timesheets/time-types - Get configured time types for a builder
- Returns available time categories (e.g., “Regular Hours”, “Overtime”, “Annual Leave”)
-
GET /timesheets/cost-codes - Get configured cost codes for a builder
- Returns project cost codes for timesheet categorization
SWMS (Safe Work Method Statements) API
New endpoints for accessing SWMS documents:
These endpoints require appropriate scopes (read:timesheets and read:swms) and follow the same authentication patterns as other API endpoints.
Need help?
If you have questions about these changes or need assistance with migration, please contact our support team.