---
title: "POST /api/v1/cert-manager/alerts/preview/certificates"
method: POST
path: "/api/v1/cert-manager/alerts/preview/certificates"
tags: ["PKI Alerting"]
---

# POST /api/v1/cert-manager/alerts/preview/certificates

`POST /api/v1/cert-manager/alerts/preview/certificates`

Preview certificates that would match the given filter rules

## Request body

- object
  - `filters` object[], required
    - `field` 'profile_name' | 'common_name' | 'san' | 'include_cas', required
    - `operator` 'equals' | 'matches' | 'contains' | 'starts_with' | 'ends_with', required
    - `value` union, required
      - string
      - string[]
      - boolean
  - `alertBefore` string — Alert timing (e.g., '30d', '1w'). Required for expiration previews, omit for other event types.
  - `limit` number
  - `offset` number

## Response `200`

Default Response

- object
  - `certificates` object[], required
    - `id` string, uuid, required
    - `serialNumber` string, required
    - `commonName` string, required
    - `san` string[], required
    - `profileName` string, nullable, required
    - `enrollmentType` string, nullable, required
    - `notBefore` string, date-time, required
    - `notAfter` string, date-time, required
    - `status` string, required
  - `total` number, required

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/infisical/apis/infisical-api.md) · [All operations](https://skmtc.net/infisical/apis/infisical-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/infisical/infisical-api/versions/885aef3e6c11/schema)