Skip to content
English
  • There are no suggestions because the search field is empty.

PSOhub API: Plans

Learn how to retrieve plans and their tasks via the PSOhub API

Published: 1 June 2026

Audience

  • Admin

Objective

This reference article covers the PSOhub API endpoint for retrieving project plans. Use this endpoint to query plans that are linked to a project, including their task lists and tasks.

Prerequisites

Eligible access
        You must have Admin user access in PSOhub.
 
API enabled
        You must have API access enabled for your PSOhub account.

Get All Plans

Use this endpoint to retrieve a list of plans from your PSOhub organization:

Endpoint

 
 
GET https://www.psohubapp.com/rest/psohubapi/v1/plans

Use the limit parameter to control the number of records returned. If not specified, the API returns 50 plans by default.

Example response

 
 

json

[   {     "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,             "AssignedTo": [               {                 "AccountID": 39406496739494241,                 "AccountName": "Art Volker",                 "AccountEmail": "art@psohub.com"               }             ]           }         ]       }     ]   } ]

Response Fields

Plan object

Name Type Description
PlanName String The name of the plan.
HubSpotDealID Integer/Long The unique ID of the linked HubSpot deal, if applicable.
PlanStage String The current stage of the plan.
StartDate DateTime The start date of the plan.
EndDate DateTime The estimated end date of the plan.
PlanID Integer/Long The unique ID of the plan.
ProjectID Integer/Long The ID of the linked project. Returns 0 if the plan is not linked to a project.

TaskList object

Each plan contains one or more task lists.

Name Type Description
TaskListName String The name of the task list.

Task object

Each task list contains one or more tasks.

Name Type Description
Title String The title of the task.
Description String The description of the task.
DueDate DateTime The due date of the task.
StartDate DateTime The start date of the task.
Priority String The priority of the task: None, Low, Medium, or High.
OrderNumber Integer The position of the task within the task list.
Status String The current task status: To_Do, In_Progress, or Done.
IsMileStone Boolean Indicates whether the task is set as a milestone.
TaskID Integer/Long The unique ID of the task.
EffortInHours Decimal The estimated effort in hours to complete the task.
HoursBooked Decimal The hours logged directly against this task.

AssignedTo object

Tasks can be assigned to multiple people. The AssignedTo array returns all assigned users for each task.

Name Type Description
AccountID Long The unique ID of the user in PSOhub.
AccountName String The full name of the user.
AccountEmail String The email address of the user.

Related Articles