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

# Search Project Clients

`POST /attendance/project-clients/search`

This endpoint allows you to retrieve project client data based on specified filters. Please note that this endpoint requires body parameters, which is why it utilizes a POST request for a read operation. <p><b>Before using this endpoint:</b></p> <ul> <li>Explore the <a href="/docs/explore-attendance-api" target="_blank">Attendance API</a> for more details on usage, rate limits, permissions, and more.</li> <li>Only project client fields mentioned in the `fields` parameter are returned. Use <a href="/reference/get_attendance-project-clients-metadata" target="_blank">project client metadata endpoint</a> to get the field IDs.</li>  <li><b>Pagination note:</b> 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> </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

- ClientSearchRequest — Request schema for searching project clients
  - `fields` string[]
  - `filters` object[] — List of filters to apply
    - `fieldId` string, required — Field ID to filter by
    - `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 clients matching the search criteria

- ClientSearchResponse
  - `items` ClientSearchResponseObject[] — Array of project client objects matching the search criteria
    - `objectType` 'projectClient' — Type of the object.
    - `fields` object — Client fields returned in search response.
      - `/projectClient/id` object — The unique identifier of the client.
        - `value` integer
        - `humanReadable` string
      - `/projectClient/name` object — The client's name as provided by the user.
        - `value` string
        - `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-clients#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)