v1

latestOpenAPI 3.1.1Proprietary2026-07-26184406877.9 KB
Projects

Search Project Tasks

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>
post/attendance/project-tasks/search

Request body

fieldsstring[]

List of field IDs to include in the response

limitinteger

Specifies the number of entries to include on each page of the results. Defaults to 50 if not supplied. Currently ignored for this endpoint.

cursorstring

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>.

includeHumanReadableboolean

Whether to include human-readable values in the response

Example request

{
  "fields": [
    "/projectTask/id",
    "/projectTask/name",
    "/projectTask/billable"
  ]
}

Response

Project tasks matching the search criteria