Sub-Project API
The Sub-Project API in XperienceHR provides an interface for managing sub projects, including creating, updating, deactivating, and listing sub-projects, ensuring seamless integration with external systems for detailed project management and tracking.
This API supports XML & JSON format for structured data exchange and requires authentication via an API key.
By integrating the Sub-Project API, organizations can efficiently manage sub project lifecycle data, ensuring accurate tracking and resource allocation within larger projects.
Overview
API Type: REST
Supported Formats: XML
API Key: Generated in the app configuration
Method: POST, GET
Sub-Project Management
Functionality:
- Create New Sub-Project
- Update Sub-Project
- Deactivate Sub-Project
- Get all Sub-Projects
Create New Sub-Project
Parameter | Min | Max | Required | Information | Description |
|---|---|---|---|---|---|
Name | 1 | 100 | ✅ |
| The sub-project name. |
Code | 1 | 30 | ✅ |
| The sub-project short name. |
Description | 0 | 500 | ❌ |
| The description of this sub-project. |
Project Type | FIXED | HOURLY | ❌ | Default value is HOURLY | The sub-project type. |
Inherit Parent Permissions | TRUE | FALSE | ❌ |
|
|
Start Date |
|
| ❌ |
| The date when the sub-project begins (format: YYYY-MM-DD). |
Finish Date |
|
| ❌ |
| The date when the sub-project ends (format: YYYY-MM-DD). |
Subproject Code | 0 | 30 | ❌ |
|
|
Project Status |
|
| ❌ |
| The status of project. |
Project Status Code |
|
| ✅ | Valid XPHR value | The short name of the sub-project status value. |
Parent Project Code |
|
| ✅ | Valid XPHR value | The code of parent project. |
Budget | 0 | Double_MAX_VALUE | ❌ |
| The amount of money expected to be spent on the sub-project ($). |
Duration | 0 | Integer_MAX_VALUE | ❌ |
| The number of hours expected to be spent on the sub-project. |
Billing Type |
|
| ❌ | Valid values: employee, activity, project | The way in which the budgeted amount is calculated. |
Rate | 0 | Double_MAX_VALUE | ❌ | Only relevant for project rate type | The sub-project rate ($). |
Duration Correction |
| Positive value | ❌ |
| The number of hours already tracked outside the application. |
Billable | TRUE | FALSE | ❌ |
| TRUE: all activities are billable; FALSE: only manually marked activities are billable |
Billable Type |
|
| ❌ |
| The way in which the budgeted amount is calculated. |
Active | TRUE | FALSE | ❌ |
| Indicates whether the project is currently active. |
Late Missing Notification | TRUE | FALSE | ❌ |
| TRUE: enabled; FALSE: disabled |
SMS Notification | TRUE | FALSE | ❌ | Valid XPHR value | Indicates if employees will receive SMS notifications when late (paid service). |
Email String |
|
| ❌ | Valid email address | The email addresses that should receive Late and Missing Notifications (multiple addresses separated by commas). |
Project Manager Logins |
|
| ❌ | Valid XPHR value | The logins for sub-project management. |
GPS Latitude | -90 | 90 | ❌ |
| The latitude of the sub-project location. |
GPS Longitude | -180 | 180 | ❌ |
| The longitude of the sub-project location. |
GPS Radius | 0 | Integer_MAX_VALUE | ❌ |
| The GPS radius in meters. |
Cost Center Code |
|
| ❌ | Valid XPHR value | The code of the cost center, only for creating a new sub-project (updating Cost Center is not supported). |
Billable Type Options | Description |
|---|---|
YES | All activities marked strictly as billable |
DEFAULT_YES | All activities marked as billable but could be unmarked |
NO | All activities marked strictly as non-billable |
DEFAULT_NO | All activities marked as non-billable but could be unmarked |
ACTIVITY | Billable flag is determined by activity setting |
Endpoint
Update Sub-Project
To update sub-project's information, match its code in request body and provide value(s) for data to be updated.
Endpoint
Get All Sub-Projects
Endpoint
Error Handling
Common errors help in debugging and correcting API usage issues.
Example 1: Missing Code
Example 2: User Not Found
Example 3: Parent Project Required
HTTP Response Codes
- 2XX Success - Operation completed successfully.
- 4XX Client Error - Likely an issue with the request, such as incorrect parameters or insufficient permissions. Returns an error message in text or XML format.
- 5XX Server Error - Indicates a server issue. Report this error if encountered.
Updated on: 08/07/2025
Thank you!