---
title: "List certificates"
method: GET
path: "/api/v1/certificates"
tags: ["Certificates"]
---

# List certificates

`GET /api/v1/certificates`

## Request

- Base URL: `http://localhost:5000`
- URL: `http://localhost:5000/api/v1/certificates`
- Auth: HTTP bearer

Returns a paginated list of certificates belonging to the authenticated user. Supports filtering by status and domain.

## Query parameters

- `status` 'pending' | 'validating' | 'active' | 'expired' | 'revoked' | 'failed'
- `domain` string
- `page` integer
- `limit` integer

## Response `200`

Certificate list with pagination

- object
  - `success` boolean
  - `data` object
    - `certificates` Certificate[]
      - `_id` string
      - `certificateId` string
      - `userId` string
      - `domains` string[]
      - `type` 'single' | 'wildcard' | 'multi-domain'
      - `status` 'pending' | 'validating' | 'active' | 'expired' | 'revoked' | 'failed'
      - `validationMethod` 'dns' | 'http' | 'email'
      - `keyType` 'rsa' | 'ecdsa'
      - `keySize` 256 | 384 | 2048 | 4096
      - `certificate` object
        - `pem` string, nullable
        - `chain` string, nullable
        - `fullchain` string, nullable
      - `csr` string, nullable
      - `serialNumber` string, nullable
      - `fingerprint` object
        - `sha1` string, nullable
        - `sha256` string, nullable
      - `issuer` object
        - `commonName` string
        - `organization` string
        - `country` string
      - `subject` object
        - `commonName` string
        - `organization` string, nullable
        - `organizationalUnit` string, nullable
        - `country` string, nullable
        - `state` string, nullable
        - `locality` string, nullable
      - `validFrom` string, date-time, nullable
      - `validTo` string, date-time, nullable
      - `expiresAt` string, date-time
      - `autoRenew` boolean
      - `renewalAttempts` integer
      - `lastRenewalAttempt` string, date-time, nullable
      - `nextRenewalDate` string, date-time
      - `validation` object
        - `records` object[]
          - `domain` string
          - `method` 'dns' | 'http' | 'email'
          - `status` 'pending' | 'valid' | 'invalid' | 'expired'
          - `token` string
          - `keyAuthorization` string
          - `validatedAt` string, date-time, nullable
          - `expiresAt` string, date-time
        - `completedAt` string, date-time, nullable
      - `monitoring` object
        - `enabled` boolean
        - `lastCheck` string, date-time, nullable
        - `nextCheck` string, date-time
      - `metadata` object
        - `tags` string[]
        - `notes` string, nullable
        - `environment` 'development' | 'staging' | 'production'
      - `isActive` boolean
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `pagination` Pagination
      - `page` integer
      - `limit` integer
      - `total` integer
      - `pages` integer

## Other responses

- `401`: Unauthorized
- `500`: Internal server error

---

[API](https://skmtc.dev/sslwebsites/apis/sslwebsites-com-api.md) · [All operations](https://skmtc.dev/sslwebsites/apis/sslwebsites-com-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sslwebsites/apis/sslwebsites-com-api/revisions/16dfd60144a0?raw)