# List org plan items

**GET /planItems**


Cross-project plan item management

## Servers
- https://open.api.missionx.ai/v2: https://open.api.missionx.ai/v2 ()


## Authentication methods
- O auth2


## Parameters


#### Query parameters
- **project** (array[string])
  One or more project IDs to filter the results by. This is the `projects[]._id` value.
- **person** (array[string])
  One or more person IDs to filter the results by. This is the `people[].person._id` value.
- **department** (array[string])
  One or more department IDs to filter the results by. This is the `org.departments[]._id` value.
- **role** (array[string])
  One or more role IDs to filter the results by. This is the `org.roles[]._id` value.
- **startDate** (string)
  A start date query to filter the results by. Format is `startDate=<operator> <date>`, e.g. `startDate=gt 2025-02-24T00:00:00.000Z`. Acceptable operations are `lt` = lower than, `lte` = lower than or equal, `gt` = greater than, `gte` = greater than or equal, `eq` = equal. The date is in [ISOString](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString).
- **endDate** (string)
  An end date query to filter the results by. Format is `endDate=<operator> <date>`, e.g. `endDate=lt 2025-02-24T00:00:00.000Z`. Acceptable operations are `lt` = lower than, `lte` = lower than or equal, `gt` = greater than, `gte` = greater than or equal, `eq` = equal. The date is in [ISOString](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString).
- **id** (array[string])
  One or more IDs to filter the response by. Compares against the document's `_id` value.
- **archived** (boolean | number)
  If true, only archived documents will be returned. Defaults to false. If you need both archived and non-archived, use `withArchived` instead.
- **withArchived** (boolean | number)
  If true, both archived and non-archived documents will be returned. Defaults to false.
- **updatedAt** (string)
  A date query to filter the results by the last `updatedAt` value. Format is `updatedAt=<operator> <date>`, e.g. `updatedAt=gt 2025-02-24T00:00:00.000Z`. Acceptable operations are `lt` = lower than, `lte` = lower than or equal, `gt` = greater than, `gte` = greater than or equal, `eq` = equal. The date is in [ISOString](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString).
- **select** (array[string])
  One or more properties to be included in the response, instead of the full payload. E.g. `select=endDate,projectStatus`. You can also exclude fields by prefixing with a minus sign, e.g. `select=-endDate,-projectStatus`, but you cannot mix both.
- **sortBy** (string)
  Optionally, the field to sort the results by. By default, results are sorted by created date. Only `updatedAt` is supported at this moment (Note: `updatedAt` equals to `createdAt` for documents that have never been updated).
- **sortDirection** (string)
  Optionally, the direction to sort the documents by. For ascending (oldest first) use either `1` or `asc`. By default sorting is descending (latest first), `-1` or `desc`.
- **limit** (integer)
  Optionally, change the default document response limit of `40`.
- **count** (boolean | number)
  Includes a `count` property in the response, which holds the total number of results matching the query. The value does not change between pages and represents the accurate, total number of results to be expected.

Note: The use of this parameter will have a performance impact on the first paginated request.


## Responses
### 200: Successful response

#### Body Parameters: application/json (object)
- **value** (array[object])
  

### 400: Bad Request

#### Body Parameters: application/json (object)
- **message** (string)
  An error message.
- **code** (string)
  An error code to handle specific error responses.
- **data** (object)
  Optionally, additional data to help handle the error.

### 500: Internal Server Error

#### Body Parameters: application/json (object)
- **message** (string)
  An error message.
- **code** (string)
  An error code to handle specific error responses.
- **data** (object)
  Optionally, additional data to help handle the error.


[Powered by Bump.sh](https://bump.sh)