> **Source:** https://knowledge.leegality.com/sign-station/api/get-summary
> **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/summary — Get certificate summary

Retrieves certificate summary statistics for the current user's organization including total certificates, active certificates (not expired and enabled), and certificates expiring within the specified number of days (defaults to 30 days)

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

## Request URL

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

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

---

## 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 — Certificate summary retrieved successfully

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Response code indicating success or failure | — |
| `message` | string | No | Response message providing additional information | — |
| `data` | CertificateSummaryVO | No | See **CertificateSummaryVO** below. | — |

#### CertificateSummaryVO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `totalCertificates` | integer | No | Total number of certificates in the system | — |
| `totalActiveCertificates` | integer | No | Total number of active (enabled) certificates | — |
| `totalExpiringSoonCertificates` | integer | No | Total number of certificates that are expiring soon | — |

### 400 — Invalid UUID provided

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

#### ErrorDetailGetCertificateSummary400VO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `Invalid UUID provided.` |
| `path` | string | No | API path that generated the error | `/api/v1/certificates/summary` |
| `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\<ErrorDetailGetCertificateSummary401VO\> | No | List of error details See **ErrorDetailGetCertificateSummary401VO** below. | — |

#### ErrorDetailGetCertificateSummary401VO

| 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/summary` |
| `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
{
  "code": "string",
  "message": "string",
  "data": {
    "totalCertificates": 0,
    "totalActiveCertificates": 0,
    "totalExpiringSoonCertificates": 0
  }
}
```