---
title: "Search Project Tasks"
method: POST
path: "/attendance/project-tasks/search"
tags: ["Projects"]
---

# Search Project Tasks

`POST /attendance/project-tasks/search`

This endpoint allows you to retrieve project task data based on specified filters.
 <p>Explore
the <a href="/docs/explore-attendance-api" target="_blank">Attendance API</a> for more details on usage, rate limits, permissions, and more.</p> 
<p><b>Notes:</b></p> <ul> <li>Only project task fields mentioned in the `fields` parameter are returned. Use <a href="/reference/get_attendance-project-tasks-metadata" target="_blank">project task metadata endpoint</a> to get the field IDs.</li>  <li>By default, only <b>active</b> project tasks will be retrieved. To fetch archived tasks, filter by `status` equals `archived`.</li>
 <li>Pagination parameters are
currently accepted but not enforced. The response includes all matching results regardless of the `limit` or `cursor` values. Pagination will be implemented in a future version to limit results per page. To learn more, see <a href="https://apidocs.hibob.com/docs/pagination" target="_blank"> Pagination in Bob’s API</a>.</li>  <li>This endpoint requires body parameters, which is why it utilizes a POST request for a read operation.</li>  </ul> <p><b>Testing notes</b>:</p>
  <ul>
  <li>Use the testing widget's <b>Try It!</b> option to test this endpoint.</li>
  <li>Use the <b>Examples > Request Example</b> option to see how to initiate body parameters.</li>
  </ul>

## Request body

- TaskSearchRequest — Request schema for searching project tasks
  - `fields` string[] — List of field IDs to include in the response
  - `filters` object[] — List of filters to apply
    - `fieldId` string, required — Field ID to filter by. The following project task fields can be used for filtering: `/projectTask/billable`, `/projectTask/id`, `/projectTask/name`, `/projectTask/status`. Use the `status` filter to fetch archived tasks, <br>You cannot filter based on custom fields via the public API.
    - `operator` 'equals' | 'notEqual', required — The operator can be `equals` or `notEqual` (for boolean you can only use `equals`)
    - `values` string[], required — Values to filter by
  - `limit` integer — Specifies the number of entries to include on each page of the results. Defaults to 50 if not supplied. Currently ignored for this endpoint.
  - `cursor` string — A marker representing the first item on the next page to read. Do not provide it in the first call. Currently ignored for this endpoint. To learn more, see <a href="https://apidocs.hibob.com/reference/pagination-1" target="_blank"> Pagination in Bob's API</a>.
  - `includeHumanReadable` boolean — Whether to include human-readable values in the response

## Response `200`

Project tasks matching the search criteria

- TaskSearchResponse
  - `items` TaskSearchResponseObject[] — Array of task objects matching the search criteria
    - `objectType` 'projectTask' — Type of the object.
    - `fields` object — Task fields returned in search response.
      - `/projectTask/id` object — The unique identifier of the task.
        - `value` integer
        - `humanReadable` string
      - `/projectTask/name` object — The task's name as provided by the user.
        - `value` string
        - `humanReadable` string
      - `/projectTask/billable` object — Whether this task is considered billable or not when tracking. billing by tasks.
        - `value` boolean
        - `humanReadable` string
      - `/projectTask/status` object — Task status (active or archived)
        - `value` 'active' | 'archived'
        - `humanReadable` string
  - `response_metadata` object
    - `next_cursor` string, nullable — A marker representing the first item on the next page to read. Do not provide it in the first call. Currently ignored for this endpoint. To learn more, see <a href="https://apidocs.hibob.com/reference/pagination-1" target="_blank"> Pagination in Bob's API</a>.

## Other responses

- `400` — The request is malformed or includes invalid parameters
- `401` — Authentication failed. Check your service user credentials
- `403` — The service user or token is missing the required permissions to access the requested data
- `429` — Rate limit exceeded - see <a href="https://apidocs.hibob.com/reference/project-tasks#rate-limiting">Rate limits</a>
- `500` — An unexpected error occurred. Try again or contact support if the issue persists.

---

[API](https://skmtc.net/hibob/apis/employee-data-api.md) · [All operations](https://skmtc.net/hibob/apis/employee-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hibob/employee-data-api/versions/0781ebbdda91/schema)