# List certificates

> List your certificates, newest first and optionally for one domain, to find the certificateId every call after the purchase needs.

## GET /api/v1/ssls

Lists your certificates, newest first, with the `certificateId` every other call needs. Filter by domain to find the certificates on one name.

**Request**

```http
GET /api/v1/ssls?domainName=apiname.com&skipCount=0&maxResultCount=10
```

| Parameter | Required | Notes |
| --- | --- | --- |
| `domainName` | optional | Only certificates on this domain. For a wildcard, `*.apiname.com` and `apiname.com` find the same certificates. |
| `skipCount` | optional | Default `0`. |
| `maxResultCount` | optional | Default `10`, maximum `1000`. |

**Response — 200**

```json
{
  "totalCount": 2,
  "items": [
    {
      "certificateId": "9b41d0e6-7c2a-4f58-8e13-6a5f2d9c7b20",
      "domainName": "apiname.com",
      "packageCode": "POSITIVESSL",
      "packageName": "PositiveSSL",
      "status": "WaitingForInstall",
      "statusReason": "None",
      "isConfigured": false,
      "isIssued": false,
      "purchasedAt": "2027-10-18T09:20:14",
      "subscriptionExpiresAt": "2028-10-18T09:20:14",
      "certificateExpiresAt": null,
      "renewedFromCertificateId": "5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042"
    },
    {
      "certificateId": "5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042",
      "domainName": "apiname.com",
      "packageCode": "POSITIVESSL",
      "packageName": "PositiveSSL",
      "status": "Active",
      "statusReason": "None",
      "isConfigured": true,
      "isIssued": true,
      "purchasedAt": "2026-10-30T16:12:40",
      "subscriptionExpiresAt": "2027-10-30T16:12:40",
      "certificateExpiresAt": "2027-11-28T23:59:59",
      "renewedFromCertificateId": null
    }
  ]
}
```

| Field | Meaning |
| --- | --- |
| `certificateId` | Send this to every other SSL endpoint. |
| `domainName`, `packageCode`, `packageName` | What the certificate is for. |
| `status` | A [certificate status](https://www.domainnameapi.com/docs/ssl/issue/#step-3--poll-for-issuance) name, e.g. `Active`, `WaitingForInstall`, `Renewed`. |
| `statusReason` | Why it reached that status — see below. |
| `isConfigured`, `isIssued` | Whether `configure` has been done, and whether the CA has issued it. |
| `purchasedAt`, `subscriptionExpiresAt` | The subscription you paid for. Renewal reminders run off `subscriptionExpiresAt`. |
| `certificateExpiresAt` | When the issued certificate stops being valid. `null` until it is issued. |
| `renewedFromCertificateId` | On a renewal: the `certificateId` of the certificate it renews. `null` otherwise. |

**Status reasons**

| Name | Meaning |
| --- | --- |
| `None` | The normal flow. |
| `ConfigurationWindowExpired` | Not configured within 15 days and cancelled. Refundable packages are refunded automatically. |
| `ResellerRevoked` | You called `revoke`. |
| `AdminCancelled` | Cancelled by our team. |
| `ProviderCancelled` | The CA cancelled the order. |
| `CertificateExpired` | The certificate ran out while the subscription is still running. Reissue it. |
| `SubscriptionExpired` | The subscription ended. Renew it. |

:::tip[Look up once, then store]
This call costs 10 quota points like any other SSL call. Use it to recover a lost id or to move an existing integration over to `certificateId` — not before every operation. Store the `certificateId` from `initialize` and `renew` and send it straight to the endpoint you need.
:::

:::note[One domain, several certificates]
The same domain can appear more than once: a renewal next to the certificate it renews, a second purchase, an old cancelled certificate. To pick the one you want, read `status`, `renewedFromCertificateId` and the dates rather than taking the first item.
:::
