---
title: "List certificates expiring within N days"
method: GET
path: "/expiring"
tags: ["Expiring"]
---

# List certificates expiring within N days

`GET /expiring`

## Request

- Base URL: `https://tlsradar.com/api/v1`
- URL: `https://tlsradar.com/api/v1/expiring`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://tlsradar.com/oauth/authorize`, token URL `https://tlsradar.com/oauth/token`, scopes: `read`, `write`)
  - HTTP bearer

Convenience query that flattens all monitored hosts the user can see and returns those whose latest scan shows an expiration date within the requested window. Sorted by days until expiration ascending.

## Query parameters

- `within` integer

## Response `200`

List of expiring monitors with metadata

## Other responses

- `401`: Invalid or missing API key

---

[API](https://skmtc.dev/tlsradar/apis/tls-radar-api.md) · [All operations](https://skmtc.dev/tlsradar/apis/tls-radar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tlsradar/apis/tls-radar-api/revisions/ecf1eb879b34?raw)