List workforce plans
GET/hr/workforce-plans
Returns all workforce plans. Each plan captures headcount assumptions and projections over a defined horizon in months. Use these plans for budgeting and scenario modelling during annual people-planning cycles.
Request
This endpoint takes no parameters and no request body.
Responses
200 List of workforce plans
Content type application/json, object.
| Field | Type | Required | Description |
|---|---|---|---|
data | array of object · WorkforcePlanV1 | No | |
data[].id | integer | No | Auto-incremented primary key. |
data[].name | string | No | Plan title (e.g. "FY2026 Headcount Plan"). Example: |
data[].horizon_months | integer | No | Number of months the plan spans. Example: |
data[].assumptions | object, nullable | No | Planning assumptions such as attrition rate and hiring budget. |
data[].plan_payload | object, nullable | No | Month-by-month headcount projections. |
data[].status | string | No | Lifecycle status of the plan. One of: |
data[].created_by | integer, nullable | No | Tenant user ID who created the plan. |
data[].created_at | string (date-time) | No | Record creation timestamp. |
Example
{
"data": [
{
"id": 1,
"name": "FY2026 Headcount Plan",
"horizon_months": 12,
"status": "active",
"assumptions": {
"attrition_rate": 0.08,
"hiring_budget": 120000
},
"plan_payload": {
"months": [
{
"month": "2026-05",
"hires": 3,
"exits": 1
}
]
},
"created_by": 1,
"created_at": "2026-01-10T08:00:00Z"
}
]
}401 Unauthenticated
Example request
curl -X GET "https://{tenant}.faciotech.net/api/v1/hr/workforce-plans" \
-H "Accept: application/json"