# Retrieve a domain certificate

`GET https://api.cademi.com.br/api/v3/account/domains/{domain_id}/certificate`

Operation ID: `account.domains.certificate.get` · API v3

Returns the TLS certificate status of the account's custom domain.

The status reflects the last state recorded by Cademí and is not checked live with the certificate provider.

Required permissions: `domains.read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `domain_id` | path | string | yes |  |

## Responses

### 200

Returns the certificate status of the custom domain.

Body: `data`: DomainCertificate.

Fields of DomainCertificate:

| Field | Type | Required | Description |
|---|---|---|---|
| `domain_id` | string | yes |  |
| `object` | string, one of `domain_certificate` | yes | String representing the object's type. |
| `reissues` | integer | yes |  |
| `requested_at` | string or null | yes | Request time exactly as reported by the certificate provider. The value is not normalized and may not follow the ISO 8601 date-time format. |
| `source` | string, one of `local_state` | yes | Origin of the status. local_state means the status reflects the last recorded state rather than a real-time check with the certificate provider. |
| `status` | string, one of `none`, `issuing`, `active` | yes |  |

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 404

The domain was not found or is not accessible with the current credentials. Also returned when the account has no custom domain.

Body: Error.

Full schema: https://cademi.dev/openapi/v3.json