> **Source:** https://knowledge.leegality.com/sign-station/api/get-expiring-soon
> **Site:** Leegality Knowledge Base — https://knowledge.leegality.com
> **About:** Leegality is a document execution platform covering eSigning, stamps, NeSL, workflows, and REST API integration.
> **Navigation:** Every article on this site has a plain-text version at `<article-url>.txt` (this format). To get an index of all articles with their `.txt` links, read: https://knowledge.leegality.com/llms.txt
> **AI Guide:** For instructions on how to navigate this knowledge base as an AI agent, read: https://knowledge.leegality.com/ai-readable.txt

---
# GET /api/v1/certificates/expiring-soon — Get certificates expiring soon

Retrieves certificates that are expiring within the specified number of days for the current user's organization. Certificates are sorted by expiry date in ascending order (earliest expiring first). Only enabled certificates with expiry dates are included.

**Authentication:** `X-Auth-Token` header required on every request.

## Request URL

```
GET https://app1.leegality.com/api/api/v1/certificates/expiring-soon?days={days}&departmentId={departmentId}
```

**Environments:**
- Production: `https://app1.leegality.com/api/api/v1/certificates/expiring-soon`
- Sandbox: `https://sandbox.leegality.com/api/api/v1/certificates/expiring-soon`

---

## Parameters

| Name | In | Required | Type | Description | Example |
|------|----|----------|------|-------------|---------|
| `days` | query | No | integer | Number of days to check for expiring certificates (defaults to 30 days) | — |
| `departmentId` | query | No | string |  | — |

---

## Responses

### 200 — Expiring certificates retrieved successfully

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `data` | array\<CertificateVO\> | No | See **CertificateVO** below. | — |

#### CertificateVO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `id` | string | No | Certificate unique identifier | `46d4e120-ed03-47cc-98c6-529bff3bbabc` |
| `name` | string | No | Certificate name | `TestCertificate.leegality.com` |
| `certificateType` | string | No | Type of the certificate Allowed: `PKCS12_PFX`, `PKCS12_HSM`, `PKCS11`. | — |
| `expiry` | string | No | Certificate expiry date | — |
| `createdAt` | string | No | The date and time when the certificate was created | — |
| `departmentId` | string | No | Associated department ID | `18b45e41-5d8b-4417-bb83-1d769187aef9` |
| `departmentName` | string | No | Associated department name | `HR` |

### 400 — Invalid request parameters provided

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Top-level error code | `LE_ERR_SS_400` |
| `errors` | array\<ErrorDetailGetCertificatesExpiringSoon400VO\> | No | List of error details See **ErrorDetailGetCertificatesExpiringSoon400VO** below. | — |

#### ErrorDetailGetCertificatesExpiringSoon400VO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `Invalid request parameters provided.` |
| `path` | string | No | API path that generated the error | `/api/v1/certificates/expiring-soon` |
| `code` | string | No | Specific error code | `null` |

### 401 — Unauthorized - Invalid or expired token

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Top-level error code | `LE_ERR_SS_401` |
| `errors` | array\<ErrorDetailGetCertificatesExpiringSoon401VO\> | No | List of error details See **ErrorDetailGetCertificatesExpiringSoon401VO** below. | — |

#### ErrorDetailGetCertificatesExpiringSoon401VO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `Invalid or expired token` |
| `path` | string | No | API path that generated the error | `/api/v1/certificates/expiring-soon` |
| `code` | string | No | Specific error code | `LE_ERR_SS_303` |

### 500 — Internal server error

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Top-level error code | `LE_ERR_SS_500` |
| `errors` | array\<ErrorDetailToken500VO\> | No | List of error details See **ErrorDetailToken500VO** below. | — |

#### ErrorDetailToken500VO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `Internal Server Error` |
| `path` | string | No | API path that generated the error | `null` |
| `code` | string | No | Specific error code | `null` |

### Sample Response (200)

```json
{
  "data": [
    {
      "id": "46d4e120-ed03-47cc-98c6-529bff3bbabc",
      "name": "TestCertificate.leegality.com",
      "certificateType": "PKCS12_PFX",
      "expiry": "string",
      "createdAt": "string",
      "departmentId": "18b45e41-5d8b-4417-bb83-1d769187aef9",
      "departmentName": "HR"
    }
  ]
}
```