--- title: "Changes to Searches for certificates confirming given criteria and pagination." method: POST path: "/v2/certificate/search" --- # Changes to Searches for certificates confirming given criteria and pagination. `POST /v2/certificate/search` > Every recorded change to this operation, newest first. ## Timeline Changed in 8 of 27 revisions. - **2026-07-17** `44f8798658e2`: 1 breaking, 18 warning, 19 info - **2025-08-14** `6cc4ab6443cf`: 1 warning, 1 info - **2025-08-14** `1df065b9d161`: 19 warning, 19 info - **2025-04-24** `f4627ea866de`: 1 breaking, 1 info - **2025-03-11** `4045b1bab09f`: 15 breaking, 1 warning, 35 info - **2025-03-11** `37878df36b77`: 2 breaking, 11 warning, 38 info - **2025-01-24** `d0f3affe7c3c`: 15 breaking, 1 warning, 35 info - **2024-07-05** `b6fc2ad168e5`: 2 breaking, 11 warning, 38 info ## Changes - **2026-07-17** `44f8798658e2`: 1 breaking, 18 warning, 19 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` - removed the optional property `certificates/items/base64Cert` from the response with the `200` status - removed the optional property `certificates/items/cAFingerprint` from the response with the `200` status - removed the optional property `certificates/items/certificateProfile` from the response with the `200` status - removed the optional property `certificates/items/certificateProfileId` from the response with the `200` status - removed the optional property `certificates/items/certificateRequest` from the response with the `200` status - removed the optional property `certificates/items/crlPartitionIndex` from the response with the `200` status - removed the optional property `certificates/items/endEntityProfile` from the response with the `200` status - removed the optional property `certificates/items/endEntityProfileId` from the response with the `200` status - removed the optional property `certificates/items/expireDate` from the response with the `200` status - removed the optional property `certificates/items/issuerDN` from the response with the `200` status - removed the optional property `certificates/items/notBefore` from the response with the `200` status - removed the optional property `certificates/items/revocationDate` from the response with the `200` status - removed the optional property `certificates/items/revocationReason` from the response with the `200` status - removed the optional property `certificates/items/serialNumber` from the response with the `200` status - removed the optional property `certificates/items/subjectAltName` from the response with the `200` status - removed the optional property `certificates/items/subjectDN` from the response with the `200` status - removed the optional property `certificates/items/subjectKeyId` from the response with the `200` status - removed the optional property `certificates/items/udpateTime` 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` - added the optional property `certificates/items/base64_cert` to the response with the `200` status - added the optional property `certificates/items/c_afingerprint` to the response with the `200` status - added the optional property `certificates/items/certificate_profile` to the response with the `200` status - added the optional property `certificates/items/certificate_profile_id` to the response with the `200` status - added the optional property `certificates/items/certificate_request` to the response with the `200` status - added the optional property `certificates/items/crl_partition_index` to the response with the `200` status - added the optional property `certificates/items/end_entity_profile` to the response with the `200` status - added the optional property `certificates/items/end_entity_profile_id` to the response with the `200` status - added the optional property `certificates/items/expire_date` to the response with the `200` status - added the optional property `certificates/items/issuer_dn` to the response with the `200` status - added the optional property `certificates/items/not_before` to the response with the `200` status - added the optional property `certificates/items/revocation_date` to the response with the `200` status - added the optional property `certificates/items/revocation_reason` to the response with the `200` status - added the optional property `certificates/items/serial_number` to the response with the `200` status - added the optional property `certificates/items/subject_alt_name` to the response with the `200` status - added the optional property `certificates/items/subject_dn` to the response with the `200` status - added the optional property `certificates/items/subject_key_id` to the response with the `200` status - added the optional property `certificates/items/udpate_time` to the response with the `200` status - **2025-08-14** `6cc4ab6443cf`: 1 warning, 1 info - removed the optional property `certificates/items/invalidityDate` from the response with the `200` status - added the optional property `certificates/items/invalidity_date` to the response with the `200` status - **2025-08-14** `1df065b9d161`: 19 warning, 19 info - removed the optional property `certificates/items/base64_cert` from the response with the `200` status - removed the optional property `certificates/items/c_afingerprint` from the response with the `200` status - removed the optional property `certificates/items/certificate_profile` from the response with the `200` status - removed the optional property `certificates/items/certificate_profile_id` from the response with the `200` status - removed the optional property `certificates/items/certificate_request` from the response with the `200` status - removed the optional property `certificates/items/crl_partition_index` from the response with the `200` status - removed the optional property `certificates/items/end_entity_profile` from the response with the `200` status - removed the optional property `certificates/items/end_entity_profile_id` from the response with the `200` status - removed the optional property `certificates/items/expire_date` from the response with the `200` status - removed the optional property `certificates/items/invalidity_date` from the response with the `200` status - removed the optional property `certificates/items/issuer_dn` from the response with the `200` status - removed the optional property `certificates/items/not_before` from the response with the `200` status - removed the optional property `certificates/items/revocation_date` from the response with the `200` status - removed the optional property `certificates/items/revocation_reason` from the response with the `200` status - removed the optional property `certificates/items/serial_number` from the response with the `200` status - removed the optional property `certificates/items/subject_alt_name` from the response with the `200` status - removed the optional property `certificates/items/subject_dn` from the response with the `200` status - removed the optional property `certificates/items/subject_key_id` from the response with the `200` status - removed the optional property `certificates/items/udpate_time` from the response with the `200` status - added the optional property `certificates/items/base64Cert` to the response with the `200` status - added the optional property `certificates/items/cAFingerprint` to the response with the `200` status - added the optional property `certificates/items/certificateProfile` to the response with the `200` status - added the optional property `certificates/items/certificateProfileId` to the response with the `200` status - added the optional property `certificates/items/certificateRequest` to the response with the `200` status - added the optional property `certificates/items/crlPartitionIndex` to the response with the `200` status - added the optional property `certificates/items/endEntityProfile` to the response with the `200` status - added the optional property `certificates/items/endEntityProfileId` to the response with the `200` status - added the optional property `certificates/items/expireDate` to the response with the `200` status - added the optional property `certificates/items/invalidityDate` to the response with the `200` status - added the optional property `certificates/items/issuerDN` to the response with the `200` status - added the optional property `certificates/items/notBefore` to the response with the `200` status - added the optional property `certificates/items/revocationDate` to the response with the `200` status - added the optional property `certificates/items/revocationReason` to the response with the `200` status - added the optional property `certificates/items/serialNumber` to the response with the `200` status - added the optional property `certificates/items/subjectAltName` to the response with the `200` status - added the optional property `certificates/items/subjectDN` to the response with the `200` status - added the optional property `certificates/items/subjectKeyId` to the response with the `200` status - added the optional property `certificates/items/udpateTime` to the response with the `200` status - **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, 1 warning, 35 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 `certificates/items/base64_cert` response's property type changed from `array` to `string`, and format from no format to `byte` for status `200` - added the new `undefined` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - 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` - the response optional property `certificates/items/base64_cert` became not read-only for the status `200` - the response optional property `certificates/items/c_afingerprint` became not read-only for the status `200` - the response optional property `certificates/items/certificate_profile` became not read-only for the status `200` - the response optional property `certificates/items/certificate_profile_id` became not read-only for the status `200` - the response optional property `certificates/items/certificate_request` became not read-only for the status `200` - the response optional property `certificates/items/crl_partition_index` became not read-only for the status `200` - the response optional property `certificates/items/end_entity_profile` became not read-only for the status `200` - the response optional property `certificates/items/end_entity_profile_id` became not read-only for the status `200` - the response optional property `certificates/items/expire_date` became not read-only for the status `200` - the response optional property `certificates/items/fingerprint` became not read-only for the status `200` - the response optional property `certificates/items/issuer_dn` became not read-only for the status `200` - the response optional property `certificates/items/not_before` became not read-only for the status `200` - the response optional property `certificates/items/revocation_date` became not read-only for the status `200` - the response optional property `certificates/items/revocation_reason` became not read-only for the status `200` - the response optional property `certificates/items/serial_number` became not read-only for the status `200` - the response optional property `certificates/items/status` became not read-only for the status `200` - the response optional property `certificates/items/subject_alt_name` became not read-only for the status `200` - the response optional property `certificates/items/subject_dn` became not read-only for the status `200` - the response optional property `certificates/items/subject_key_id` became not read-only for the status `200` - the response optional property `certificates/items/tag` became not read-only for the status `200` - the response optional property `certificates/items/type` became not read-only for the status `200` - the response optional property `certificates/items/udpate_time` became not read-only for the status `200` - the response optional property `certificates/items/username` became not read-only for the status `200` - …11 more - **2025-03-11** `37878df36b77`: 2 breaking, 11 warning, 38 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 `certificates/items/base64_cert` response's property type changed from `string` to `array`, and format from `byte` to no format for status `200` - added the new `-1.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `0.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `1.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `10.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `2.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `3.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `4.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `5.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `6.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `8.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `9.00` enum value to the `certificates/items/revocation_reason` response property for the response 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` - the response optional property `certificates/items/base64_cert` became read-only for the status `200` - the response optional property `certificates/items/c_afingerprint` became read-only for the status `200` - the response optional property `certificates/items/certificate_profile` became read-only for the status `200` - the response optional property `certificates/items/certificate_profile_id` became read-only for the status `200` - the response optional property `certificates/items/certificate_request` became read-only for the status `200` - the response optional property `certificates/items/crl_partition_index` became read-only for the status `200` - the response optional property `certificates/items/end_entity_profile` became read-only for the status `200` - the response optional property `certificates/items/end_entity_profile_id` became read-only for the status `200` - the response optional property `certificates/items/expire_date` became read-only for the status `200` - the response optional property `certificates/items/fingerprint` became read-only for the status `200` - the response optional property `certificates/items/issuer_dn` became read-only for the status `200` - the response optional property `certificates/items/not_before` became read-only for the status `200` - the response optional property `certificates/items/revocation_date` became read-only for the status `200` - …11 more - **2025-01-24** `d0f3affe7c3c`: 15 breaking, 1 warning, 35 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 `certificates/items/base64_cert` response's property type changed from `array` to `string`, and format from no format to `byte` for status `200` - added the new `undefined` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - 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` - the response optional property `certificates/items/base64_cert` became not read-only for the status `200` - the response optional property `certificates/items/c_afingerprint` became not read-only for the status `200` - the response optional property `certificates/items/certificate_profile` became not read-only for the status `200` - the response optional property `certificates/items/certificate_profile_id` became not read-only for the status `200` - the response optional property `certificates/items/certificate_request` became not read-only for the status `200` - the response optional property `certificates/items/crl_partition_index` became not read-only for the status `200` - the response optional property `certificates/items/end_entity_profile` became not read-only for the status `200` - the response optional property `certificates/items/end_entity_profile_id` became not read-only for the status `200` - the response optional property `certificates/items/expire_date` became not read-only for the status `200` - the response optional property `certificates/items/fingerprint` became not read-only for the status `200` - the response optional property `certificates/items/issuer_dn` became not read-only for the status `200` - the response optional property `certificates/items/not_before` became not read-only for the status `200` - the response optional property `certificates/items/revocation_date` became not read-only for the status `200` - the response optional property `certificates/items/revocation_reason` became not read-only for the status `200` - the response optional property `certificates/items/serial_number` became not read-only for the status `200` - the response optional property `certificates/items/status` became not read-only for the status `200` - the response optional property `certificates/items/subject_alt_name` became not read-only for the status `200` - the response optional property `certificates/items/subject_dn` became not read-only for the status `200` - the response optional property `certificates/items/subject_key_id` became not read-only for the status `200` - the response optional property `certificates/items/tag` became not read-only for the status `200` - the response optional property `certificates/items/type` became not read-only for the status `200` - the response optional property `certificates/items/udpate_time` became not read-only for the status `200` - the response optional property `certificates/items/username` became not read-only for the status `200` - …11 more - **2024-07-05** `b6fc2ad168e5`: 2 breaking, 11 warning, 38 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 `certificates/items/base64_cert` response's property type changed from `string` to `array`, and format from `byte` to no format for status `200` - added the new `-1.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `0.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `1.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `10.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `2.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `3.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `4.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `5.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `6.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `8.00` enum value to the `certificates/items/revocation_reason` response property for the response status `200` - added the new `9.00` enum value to the `certificates/items/revocation_reason` response property for the response 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` - the response optional property `certificates/items/base64_cert` became read-only for the status `200` - the response optional property `certificates/items/c_afingerprint` became read-only for the status `200` - the response optional property `certificates/items/certificate_profile` became read-only for the status `200` - the response optional property `certificates/items/certificate_profile_id` became read-only for the status `200` - the response optional property `certificates/items/certificate_request` became read-only for the status `200` - the response optional property `certificates/items/crl_partition_index` became read-only for the status `200` - the response optional property `certificates/items/end_entity_profile` became read-only for the status `200` - the response optional property `certificates/items/end_entity_profile_id` became read-only for the status `200` - the response optional property `certificates/items/expire_date` became read-only for the status `200` - the response optional property `certificates/items/fingerprint` became read-only for the status `200` - the response optional property `certificates/items/issuer_dn` became read-only for the status `200` - the response optional property `certificates/items/not_before` became read-only for the status `200` - the response optional property `certificates/items/revocation_date` became read-only for the status `200` - …11 more --- [Operation](https://skmtc.dev/keyfactor/apis/ejbca-rest-interface/docs/v2/certificate/search/post.md) - [API](https://skmtc.dev/keyfactor/apis/ejbca-rest-interface.md) - [Page](https://skmtc.dev/keyfactor/apis/ejbca-rest-interface/changes/v2/certificate/search/post)