---
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-03-11** `4045b1bab09f` — 2 breaking
  - the `certificates_rest_response/certificates/items/certificate` response's property type/format changed from `array`/`` to `string`/`byte` for status `200`
  - the `certificates_rest_response/certificates/items/certificate_chain/items/` response's property type/format changed from `array`/`` to `string`/`byte` for status `200`
- **2025-03-11** `37878df36b77` — 2 breaking
  - the `certificates_rest_response/certificates/items/certificate` response's property type/format changed from `string`/`byte` to `array`/`` for status `200`
  - the `certificates_rest_response/certificates/items/certificate_chain/items/` response's property type/format changed from `string`/`byte` to `array`/`` for status `200`
- **2025-01-24** `d0f3affe7c3c` — 2 breaking
  - the `certificates_rest_response/certificates/items/certificate` response's property type/format changed from `array`/`` to `string`/`byte` for status `200`
  - the `certificates_rest_response/certificates/items/certificate_chain/items/` response's property type/format changed from `array`/`` to `string`/`byte` for status `200`
- …earlier changes not shown

[Full 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/44f8798658e2/schema)