List projects
GET/api/projects
This endpoint handles both the Project List and the Pipeline Opportunities as a single "project" resource.
Required permissions:
- pipeline.view: allows view resources where the user is the PM or the Account.
- pipeline.view_other: allows view resources where the user is not the PM nor the Account.
Here the dedicated support page.
Request
Query Parameters
- On a date
- Greater than
- Lower than
Possible values: <= 100
Default value: 100
The number of items to include in the response.
Default value: 0
The offset of the first returned item.
Filter items by the updated_at field. This is in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
Filter items updated on a date.
Example: 2024-01-01T20:00:00%2B02:00
Filter items updated after a date.
Example: gt:2024-01-01T20:00:00%2B02:00
Filter items updated before a date.
Example: lt:2024-01-01T20:00:00%2B02:00
Header Parameters
The company you want to interact with
The API version you want to use
Responses
- 200
- 400
Returns the list of projects
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Possible values: >= 1
The estimate of the project in K
Possible values: <= 100
The probability of the project
The first day of month where the project started
Possible values: >= 1
Duration of the project in months
The date the project was archived
The date the project is supposed to end
The date the project has been signed
Possible values: >= 1
ID of the job order category
Possible values: >= 1
ID of the project type
Possible values: >= 1
ID of the client
Possible values: >= 1
ID of the person who is the project manager
Possible values: >= 1
ID of the person who is the account
Possible values: >= 1
ID of the customer
Possible values: >= 1
ID of the reason why the project is won or lost
Possible values: >= 1
ID of the business unit
Possible values: >= 1
ID of the billing group the project is in
[
{
"id": 1,
"created_at": "2024-12-20T14:44:08.320Z",
"updated_at": "2024-12-20T14:44:08.320Z",
"name": "First project",
"job_order": "jo_001",
"client_po": "po_001",
"estimate": "1.5",
"probability": "50",
"date_start": "2024-01-01",
"duration": "4",
"is_archived": true,
"archived_on": "2024-01-01",
"due_date": "2024-01-01",
"signed_on": "2024-01-01",
"job_order_category_id": 1,
"project_type_id": 1,
"client_id": 1,
"pm_id": 1,
"account_id": 1,
"customer_id": 1,
"reason_why_id": 1,
"business_unit_id": 1,
"billing_group_id": 1
}
]
Bad request