Developers

Retrieve projects list

GET
/project/projects

Retrieve projects list

Authorization<token>

Value for the Authorization header parameter.

In: header

Query Parameters

page?integer

The collection page number

Default1
itemsPerPage?integer

The number of items per page

Range0 <= value <= 100
Default30
pagination?boolean

Enable or disable pagination

search?string
dateOverlap?string
isFavorite?boolean
excludeIds[]?array<string>
order[favoriteProjects]?string
Default"asc"

Value in

  • "asc"
  • "desc"
contractors?string
contractors.id[]?string
customFieldValue[{customFieldDefinitionId}]?string
customFieldValueRange[{customFieldDefinitionId}][gt]?string
customFieldValueRange[{customFieldDefinitionId}][lt]?string
customFieldValueRange[{customFieldDefinitionId}][gte]?string
customFieldValueRange[{customFieldDefinitionId}][lte]?string
status?string
status[]?array<string>
assignedProjectUsers.projectUser?string
assignedProjectUsers.projectUser[]?array<string>
assignedProjectUsers.role?string
assignedProjectUsers.role[]?array<string>
category?string
category[]?array<string>
numbering?string
numbering[]?array<string>
tags?string
tags[]?array<string>
projectUserPMAssignedToProject[]?array<string>
order[numbering.number]?string
Default"asc"

Value in

  • "asc"
  • "desc"
dateStartPlanned[before]?string
dateStartPlanned[strictly_before]?string
dateStartPlanned[after]?string
dateStartPlanned[strictly_after]?string
dateEndPlanned[before]?string
dateEndPlanned[strictly_before]?string
dateEndPlanned[after]?string
dateEndPlanned[strictly_after]?string
dateStart[before]?string
dateStart[strictly_before]?string
dateStart[after]?string
dateStart[strictly_after]?string
dateEnd[before]?string
dateEnd[strictly_before]?string
dateEnd[after]?string
dateEnd[strictly_after]?string
updatedAt[before]?string
updatedAt[strictly_before]?string
updatedAt[after]?string
updatedAt[strictly_after]?string
order[createdAt]?string
Default"asc"

Value in

  • "asc"
  • "desc"
order[updatedAt]?string
Default"asc"

Value in

  • "asc"
  • "desc"
order[dateStart]?string
Default"asc"

Value in

  • "asc"
  • "desc"
order[dateEnd]?string
Default"asc"

Value in

  • "asc"
  • "desc"
order[dateStartPlanned]?string
Default"asc"

Value in

  • "asc"
  • "desc"
order[dateEndPlanned]?string
Default"asc"

Value in

  • "asc"
  • "desc"
order[name]?string
Default"asc"

Value in

  • "asc"
  • "desc"
order[number]?string
Default"asc"

Value in

  • "asc"
  • "desc"
order[progress]?string
Default"asc"

Value in

  • "asc"
  • "desc"
order[taskCountTotal]?string
Default"asc"

Value in

  • "asc"
  • "desc"
order[timeReported]?string
Default"asc"

Value in

  • "asc"
  • "desc"

Response Body

curl -X GET "https://example.com/project/projects"
[  {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "shortCode": "string",    "isSimple": false,    "simpleBoardShortCode": "string",    "name": "string",    "no": "string",    "contractors": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string"      }    ],    "category": {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string"    },    "dateStart": "2019-08-24T14:15:22Z",    "dateEnd": "2019-08-24T14:15:22Z",    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z",    "dateStartPlanned": "2019-08-24T14:15:22Z",    "dateEndPlanned": "2019-08-24T14:15:22Z",    "duration": 0,    "status": "in-preparation",    "isFavorite": false,    "userPermissions": [      "canManage"    ],    "assignedProjectUsers": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "projectUser": {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "shortCode": "string",          "firstName": "string",          "lastName": "string",          "email": "string",          "pictureSm": "string",          "pictureLg": "string",          "contractorId": "8e641c22-41f4-4818-ae43-d2cb9b53e3d7",          "contractorName": "string",          "canLogIn": true,          "phoneNumber": "string",          "jobPositionName": "string",          "hourlyRate": null,          "isExternal": true,          "decorator": "string"        },        "role": "none",        "hourlyRate": null,        "canReportTime": true      }    ],    "progress": null,    "budget": null,    "taskCountTotal": null,    "taskCountDone": null,    "timePlanned": null,    "timeReported": null,    "timeRealizationPercent": 0,    "tags": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string"      }    ],    "costEstimated": 0,    "costSum": 0,    "incomePlanned": 0,    "incomeSum": 0,    "financialResult": 0,    "budgetUsagePercent": 0,    "customFields": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "valueId": "b772d050-4ba4-443b-8ca7-cc1e42bdd731",        "name": "string",        "description": "string",        "dataType": "text",        "valueText": "string",        "valueFloat": "string",        "valueDateTime": "2019-08-24T14:15:22Z",        "valueSelectOptions": [          {            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",            "value": "string",            "weight": 0,            "decorator": "#78909c"          }        ],        "valueSelectUsers": [          {            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",            "firstName": "string",            "lastName": "string",            "email": "string",            "pictureSm": "string"          }        ],        "valueDepartment": {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "name": "string"        }      }    ]  }]