---
title: "Get the certificate list."
method: GET
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/certificates"
tags: ["Certificates"]
---

# Get the certificate list.

`GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/certificates`

Returns the list of certificates.

## Path parameters

- `subscriptionId` string, required
- `resourceGroupName` string, required
- `resourceName` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The body contains all the certificate list.

- CertificateListDescription — The JSON-serialized array of Certificate objects.
  - `value` CertificateDescription[] — The array of Certificate objects.
    - `properties` CertificateProperties — The description of an X509 CA Certificate.
      - `subject` string — The certificate's subject name.
      - `expiry` string, date-time-rfc1123 — The certificate's expiration date and time.
      - `thumbprint` string — The certificate's thumbprint.
      - `isVerified` boolean — Determines whether certificate has been verified.
      - `created` string, date-time-rfc1123 — The certificate's create date and time.
      - `updated` string, date-time-rfc1123 — The certificate's last update date and time.
      - `certificate` string — The certificate content
    - `id` string — The resource identifier.
    - `name` string — The name of the certificate.
    - `etag` string — The entity tag.
    - `type` string — The resource type.

## Other responses

- `default` — DefaultErrorResponse

---

[API](https://skmtc.net/azure/apis/iothubclient.md) · [All operations](https://skmtc.net/azure/apis/iothubclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/iothubclient/versions/a0bee5faaac7/schema)