---
title: "Changes to Searches for certificates confirming given criteria."
method: POST
path: "/v1/certificate/search"
---

# Changes to Searches for certificates confirming given criteria.

`POST /v1/certificate/search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 27 revisions.

- **2026-07-17** `44f8798658e2`: 1 breaking, 1 info
- **2025-04-24** `f4627ea866de`: 1 breaking, 1 info
- **2025-03-11** `4045b1bab09f`: 15 breaking, 2 warning, 1 info
- **2025-03-11** `37878df36b77`: 2 breaking, 16 info
- **2025-01-24** `d0f3affe7c3c`: 15 breaking, 2 warning, 1 info
- **2024-07-05** `b6fc2ad168e5`: 2 breaking, 16 info

## Changes

- **2026-07-17** `44f8798658e2`: 1 breaking, 1 info
  - removed the enum value `QUERY, SERIAL_NUMBER, USERNAME, SUBJECT_DN, SUBJECT_ALT_NAME, END_ENTITY_PROFILE, CERTIFICATE_PROFILE, EXTERNAL_ACCOUNT_BINDING_ID, CA, STATUS, ISSUED_DATE, EXPIRE_DATE, REVOCATION_DATE` of the request property `criteria/items/property`
  - added the new `QUERY, SERIAL_NUMBER, USERNAME, SUBJECT_DN, SUBJECT_ALT_NAME, EXTERNAL_ACCOUNT_BINDING_ID, END_ENTITY_PROFILE, CERTIFICATE_PROFILE, EXTERNAL_ACCOUNT_BINDING_ID, CA, STATUS, ISSUED_DATE, EXPIRE_DATE, REVOCATION_DATE` enum value to the request property `criteria/items/property`
- **2025-04-24** `f4627ea866de`: 1 breaking, 1 info
  - removed the enum value `QUERY, SERIAL_NUMBER, USERNAME, SUBJECT_DN, SUBJECT_ALT_NAME, EXTERNAL_ACCOUNT_BINDING_ID, END_ENTITY_PROFILE, CERTIFICATE_PROFILE, EXTERNAL_ACCOUNT_BINDING_ID, CA, STATUS, ISSUED_DATE, EXPIRE_DATE, REVOCATION_DATE` of the request property `criteria/items/property`
  - added the new `QUERY, SERIAL_NUMBER, USERNAME, SUBJECT_DN, SUBJECT_ALT_NAME, END_ENTITY_PROFILE, CERTIFICATE_PROFILE, EXTERNAL_ACCOUNT_BINDING_ID, CA, STATUS, ISSUED_DATE, EXPIRE_DATE, REVOCATION_DATE` enum value to the request property `criteria/items/property`
- **2025-03-11** `4045b1bab09f`: 15 breaking, 2 warning, 1 info
  - removed the enum value `CA` of the request property `criteria/items/property`
  - removed the enum value `CERTIFICATE_PROFILE` of the request property `criteria/items/property`
  - removed the enum value `END_ENTITY_PROFILE` of the request property `criteria/items/property`
  - removed the enum value `EXPIRE_DATE` of the request property `criteria/items/property`
  - removed the enum value `EXTERNAL_ACCOUNT_BINDING_ID` of the request property `criteria/items/property`
  - removed the enum value `EXTERNAL_ACCOUNT_BINDING_ID` of the request property `criteria/items/property`
  - removed the enum value `ISSUED_DATE` of the request property `criteria/items/property`
  - removed the enum value `QUERY` of the request property `criteria/items/property`
  - removed the enum value `REVOCATION_DATE` of the request property `criteria/items/property`
  - removed the enum value `SERIAL_NUMBER` of the request property `criteria/items/property`
  - removed the enum value `STATUS` of the request property `criteria/items/property`
  - removed the enum value `SUBJECT_ALT_NAME` of the request property `criteria/items/property`
  - removed the enum value `SUBJECT_DN` of the request property `criteria/items/property`
  - removed the enum value `USERNAME` of the request property `criteria/items/property`
  - the response's body type changed from `object` to `array` for status `200`
  - removed the optional property `certificates` from the response with the `200` status
  - removed the optional property `more_results` from the response with the `200` status
  - added the new `QUERY, SERIAL_NUMBER, USERNAME, SUBJECT_DN, SUBJECT_ALT_NAME, EXTERNAL_ACCOUNT_BINDING_ID, END_ENTITY_PROFILE, CERTIFICATE_PROFILE, EXTERNAL_ACCOUNT_BINDING_ID, CA, STATUS, ISSUED_DATE, EXPIRE_DATE, REVOCATION_DATE` enum value to the request property `criteria/items/property`
- **2025-03-11** `37878df36b77`: 2 breaking, 16 info
  - removed the enum value `QUERY, SERIAL_NUMBER, USERNAME, SUBJECT_DN, SUBJECT_ALT_NAME, EXTERNAL_ACCOUNT_BINDING_ID, END_ENTITY_PROFILE, CERTIFICATE_PROFILE, EXTERNAL_ACCOUNT_BINDING_ID, CA, STATUS, ISSUED_DATE, EXPIRE_DATE, REVOCATION_DATE` of the request property `criteria/items/property`
  - the response's body type changed from `array` to `object` for status `200`
  - added the new `CA` enum value to the request property `criteria/items/property`
  - added the new `CERTIFICATE_PROFILE` enum value to the request property `criteria/items/property`
  - added the new `END_ENTITY_PROFILE` enum value to the request property `criteria/items/property`
  - added the new `EXPIRE_DATE` enum value to the request property `criteria/items/property`
  - added the new `EXTERNAL_ACCOUNT_BINDING_ID` enum value to the request property `criteria/items/property`
  - added the new `EXTERNAL_ACCOUNT_BINDING_ID` enum value to the request property `criteria/items/property`
  - added the new `ISSUED_DATE` enum value to the request property `criteria/items/property`
  - added the new `QUERY` enum value to the request property `criteria/items/property`
  - added the new `REVOCATION_DATE` enum value to the request property `criteria/items/property`
  - added the new `SERIAL_NUMBER` enum value to the request property `criteria/items/property`
  - added the new `STATUS` enum value to the request property `criteria/items/property`
  - added the new `SUBJECT_ALT_NAME` enum value to the request property `criteria/items/property`
  - added the new `SUBJECT_DN` enum value to the request property `criteria/items/property`
  - added the new `USERNAME` enum value to the request property `criteria/items/property`
  - added the optional property `certificates` to the response with the `200` status
  - added the optional property `more_results` to the response with the `200` status
- **2025-01-24** `d0f3affe7c3c`: 15 breaking, 2 warning, 1 info
  - removed the enum value `CA` of the request property `criteria/items/property`
  - removed the enum value `CERTIFICATE_PROFILE` of the request property `criteria/items/property`
  - removed the enum value `END_ENTITY_PROFILE` of the request property `criteria/items/property`
  - removed the enum value `EXPIRE_DATE` of the request property `criteria/items/property`
  - removed the enum value `EXTERNAL_ACCOUNT_BINDING_ID` of the request property `criteria/items/property`
  - removed the enum value `EXTERNAL_ACCOUNT_BINDING_ID` of the request property `criteria/items/property`
  - removed the enum value `ISSUED_DATE` of the request property `criteria/items/property`
  - removed the enum value `QUERY` of the request property `criteria/items/property`
  - removed the enum value `REVOCATION_DATE` of the request property `criteria/items/property`
  - removed the enum value `SERIAL_NUMBER` of the request property `criteria/items/property`
  - removed the enum value `STATUS` of the request property `criteria/items/property`
  - removed the enum value `SUBJECT_ALT_NAME` of the request property `criteria/items/property`
  - removed the enum value `SUBJECT_DN` of the request property `criteria/items/property`
  - removed the enum value `USERNAME` of the request property `criteria/items/property`
  - the response's body type changed from `object` to `array` for status `200`
  - removed the optional property `certificates` from the response with the `200` status
  - removed the optional property `more_results` from the response with the `200` status
  - added the new `QUERY, SERIAL_NUMBER, USERNAME, SUBJECT_DN, SUBJECT_ALT_NAME, EXTERNAL_ACCOUNT_BINDING_ID, END_ENTITY_PROFILE, CERTIFICATE_PROFILE, EXTERNAL_ACCOUNT_BINDING_ID, CA, STATUS, ISSUED_DATE, EXPIRE_DATE, REVOCATION_DATE` enum value to the request property `criteria/items/property`
- **2024-07-05** `b6fc2ad168e5`: 2 breaking, 16 info
  - removed the enum value `QUERY, SERIAL_NUMBER, USERNAME, SUBJECT_DN, SUBJECT_ALT_NAME, EXTERNAL_ACCOUNT_BINDING_ID, END_ENTITY_PROFILE, CERTIFICATE_PROFILE, EXTERNAL_ACCOUNT_BINDING_ID, CA, STATUS, ISSUED_DATE, EXPIRE_DATE, REVOCATION_DATE` of the request property `criteria/items/property`
  - the response's body type changed from `array` to `object` for status `200`
  - added the new `CA` enum value to the request property `criteria/items/property`
  - added the new `CERTIFICATE_PROFILE` enum value to the request property `criteria/items/property`
  - added the new `END_ENTITY_PROFILE` enum value to the request property `criteria/items/property`
  - added the new `EXPIRE_DATE` enum value to the request property `criteria/items/property`
  - added the new `EXTERNAL_ACCOUNT_BINDING_ID` enum value to the request property `criteria/items/property`
  - added the new `EXTERNAL_ACCOUNT_BINDING_ID` enum value to the request property `criteria/items/property`
  - added the new `ISSUED_DATE` enum value to the request property `criteria/items/property`
  - added the new `QUERY` enum value to the request property `criteria/items/property`
  - added the new `REVOCATION_DATE` enum value to the request property `criteria/items/property`
  - added the new `SERIAL_NUMBER` enum value to the request property `criteria/items/property`
  - added the new `STATUS` enum value to the request property `criteria/items/property`
  - added the new `SUBJECT_ALT_NAME` enum value to the request property `criteria/items/property`
  - added the new `SUBJECT_DN` enum value to the request property `criteria/items/property`
  - added the new `USERNAME` enum value to the request property `criteria/items/property`
  - added the optional property `certificates` to the response with the `200` status
  - added the optional property `more_results` to the response with the `200` status

---

[Operation](https://skmtc.dev/keyfactor/apis/ejbca-rest-interface/docs/v1/certificate/search/post.md) - [API](https://skmtc.dev/keyfactor/apis/ejbca-rest-interface.md) - [Page](https://skmtc.dev/keyfactor/apis/ejbca-rest-interface/changes/v1/certificate/search/post)
