PSOhub API - Plans
Learn how to retrieve plans via the API
With this endpoint, you can find plans that are related to a project or are a seperate plan.
Get all plans(filtered)
To get all plans, you can use the following endpoint
GET https://www.psohubapp.com/rest/psohubapi/v1/plans
You can use the limit parameter to determine the number of records to return. If you don't send this, we will send back 50 plans.
If successful, the response will be this:
[
{
"PlanName": "Design New Property",
"HubSpotDealID": 32523520,
"PlanStage": "Active",
"PlanID": 126945214504979942,
"ProjectID": 895235892352323,
"TaskLists": [
{
"TaskListName": "10.004 - Design",
"Tasks": [
{
"Title": "Drawing",
"DueDate": "2025-01-13T23:58:00.000Z",
"Priority": "None",
"OrderNumber": 1,
"Status": "Done",
"StartDate": "2024-12-16T00:00:00.000Z",
"IsMileStone": false,
"TaskID": 0,
"EffortInHours": 8,
"HoursBooked": 0,
"AssignedTos": [
{
"AccountID": 39406496739494241,
"AccountName": "Art Volker",
"AccountEmail": "art@psohub.com"
}
]
},
{
"Title": "Measuring",
"DueDate": "2025-01-13T23:58:00.000Z",
"Priority": "None",
"OrderNumber": 7,
"Status": "To_Do",
"StartDate": "2024-12-16T00:00:00.000Z",
"IsMileStone": false,
"TaskID": 3525253242620,
"EffortInHours": 8,
"HoursBooked": 0,
"AssignedTo": [
{
"AccountID": 39406496739494241,
"AccountName": "Art Volker",
"AccountEmail": "art@psohub.com"
}
]
},
{
"Title": "Building Inspection",
"DueDate": "2025-01-13T23:58:00.000Z",
"Priority": "None",
"OrderNumber": 8,
"Status": "To_Do",
"StartDate": "2024-12-16T00:00:00.000Z",
"IsMileStone": false,
"TaskID": 0,
"EffortInHours": 8,
"HoursBooked": 0,
"AssignedTo": [
{
"AccountID": 39406496739494241,
"AccountName": "Art Volker",
"AccountEmail": "art@psohub.com"
}
]
}
]
The following fields will be returned to you
Name |
Type |
Description |
PlanName |
String |
Name of the plan |
HubSpotDealID |
Integer/Long |
Unique ID of HubSpot related deal , if applicable |
PlanStage |
String |
Stage name of the plan |
StartDate |
DateTime |
Start date of the plan |
EndDate |
DateTime |
ETA date of the plan |
PlanID |
Integer/long |
Unique ID of the plan |
ProjectID |
Integer/Long |
Project ID if there is a project connected, else its 0 |
Tasklist - TaskList |
String |
Name of a tasklist |
Task - Title |
String |
Title of the task |
Task - Description |
String |
Description of the task |
Task - DueDate |
DateTime |
When the task is due |
Task - StartDate |
DateTime |
When the task will start |
Task - Priority |
String |
Priority of the task |
Task - OrderNumber |
Integer |
The order within the tasklist |
Task - Status |
String |
To do / in progress / done |
Task - isMileStone |
Boolean |
If the task is set as a milestone |
Task - TaskID |
Integer/Long |
Unique number of the task |
Task - EffortInHours |
Decimal |
How much effort is estimated to be completed |
Task - HoursBooked |
Decimal |
Hours that have been booked directly on the task |
A task can be assigned to multiple people. We will return a list of people assigned, if available
Name |
Type |
Description |
AccountID |
Long |
The unique ID in PSOhub |
AccountName |
String |
Full name of the account |
AccountEmail |
String |
The email associated with the account |