---
title: "Get a list of certificates that are about to expire"
method: GET
path: "/v1/certificate/expire"
tags: ["v1/certificate"]
---

# Get a list of certificates that are about to expire

`GET /v1/certificate/expire`

List of certificates expiring within specified number of days

## Query parameters

- `days` integer
- `offset` integer
- `maxNumberOfResults` integer

## Response `200`

Successful operation

- ExpiringCertificatesRestResponse
  - `pagination_rest_response_component` PaginationRestResponseComponent
    - `more_results` boolean
    - `next_offset` integer
    - `number_of_results` integer
  - `certificates_rest_response` CertificatesRestResponse
    - `certificates` CertificateRestResponse[]
      - `certificate` string, byte — Certificate
      - `serial_number` string — Hex Serial Number
      - `response_format` string — Response format
      - `certificate_chain` string[] — Certificate chain
      - `certificate_profile` string — Certificate profile name
      - `end_entity_profile` string — End Entity profile name

## Changes

- **2025-01-24** `d0f3affe7c3c` — 2 breaking
  - the `certificates_rest_response/certificates/items/certificate` response's property type changed from `array` to `string`, and format from no format to `byte` for status `200`
  - the `certificates_rest_response/certificates/items/certificate_chain/items/` response's property type changed from `array` to `string`, and format from no format to `byte` for status `200`
- **2024-07-05** `b6fc2ad168e5` — 2 breaking
  - the `certificates_rest_response/certificates/items/certificate` response's property type changed from `string` to `array`, and format from `byte` to no format for status `200`
  - the `certificates_rest_response/certificates/items/certificate_chain/items/` response's property type changed from `string` to `array`, and format from `byte` to no format for status `200`

[Change history](https://skmtc.dev/keyfactor/apis/ejbca-rest-interface/changes/v1/certificate/expire/get.md)

---

[API](https://skmtc.dev/keyfactor/apis/ejbca-rest-interface.md) · [All operations](https://skmtc.dev/keyfactor/apis/ejbca-rest-interface/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keyfactor/ejbca-rest-interface/revisions/d0f3affe7c3c/schema)