---
title: "Search candidate qualifications licenses"
method: POST
path: "/hiring/candidate-qualifications-licenses/search"
tags: ["Candidates"]
---

# Search candidate qualifications licenses

`POST /hiring/candidate-qualifications-licenses/search`

## Request

- Base URL: `https://api.hibob.com/v1`
- URL: `https://api.hibob.com/v1/hiring/candidate-qualifications-licenses/search`
- Auth: HTTP basic

Searches candidate qualification and license records using filters and returns paginated results.

<ul>
  <li>Use the <code>fields</code> parameter to specify which fields to return</li>
  <li>Use the <code>filters</code> parameter to narrow down results</li>
  <li>Use cursor-based pagination with <code>limit</code> and <code>cursor</code></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

- CandidateQualificationsLicensesSearchRequest
  - `fields` string[], required: Required list of field IDs to include in the response (1–50 fields). The property must be provided; if omitted or not provided, the API returns an error. You must explicitly choose which fields to fetch. For all available field IDs, see the <code>fields</code> object defined on each item in the 200 response schema.
  - `filters` object[]
    - `fieldId` '/candidateQualificationsLicenses/id' | '/candidateQualificationsLicenses/candidateId' | '/candidateQualificationsLicenses/applicationId', required: Field ID to filter by
    - `operator` 'equals' | 'notEqual' | 'greaterThan' | 'lessThan', required: Filter operator. Use 'equals'/'notEqual' for exact matching. Use 'greaterThan'/'lessThan' for date range filtering.
    - `values` union[], required
      - union
        - string
        - number
  - `limit` integer
  - `cursor` string
  - `includeArchived` boolean

## Response `200`

Successfully retrieved candidate qualification and license records

- CandidateQualificationsLicensesSearchResponse
  - `items` CandidateQualificationsLicensesSearchResponseObject[], required: Array of candidate qualifications licenses objects
    - `/candidateQualificationsLicenses/id` integer: Unique identifier
    - `/candidateQualificationsLicenses/qualificationsLicensesName` string: Qualification or license name
    - `/candidateQualificationsLicenses/qualificationsLicensesBody` string: Issuing body
    - `/candidateQualificationsLicenses/dateOfIssue` string, date: Date of issue
    - `/candidateQualificationsLicenses/dateOfExpiry` string, date: Date of expiry
    - `/candidateQualificationsLicenses/candidateId` number: ID of the associated candidate.<br /><br />To fetch the candidate, use <a href="https://apidocs.hibob.com/reference/post_hiring-candidates-search" target="_blank">Search candidates ↗</a>.
    - `/candidateQualificationsLicenses/applicationId` number: ID of the associated application.<br /><br />To fetch the application, use <a href="https://apidocs.hibob.com/reference/post_hiring-applications-search" target="_blank">Search applications ↗</a>.
  - `response_metadata` object, required
    - `next_cursor` string, nullable: Cursor for next page. Null if no more results.

## Other responses

- `400`: Bad Request - Invalid parameters
- `401`: Unauthorized - Invalid or missing credentials
- `403`: Forbidden - IP not allowed or feature not enabled
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/hibob/apis/bob-hiring-api.md) - [All operations](https://skmtc.dev/hibob/apis/bob-hiring-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hibob/apis/bob-hiring-api/revisions/c758e371fc83?raw)