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

# GET /certificates

`GET /certificates`

Lists all of the certificates that have been added to the specified account.

## Query parameters

- `$filter` string
- `$select` string
- `maxresults` integer
- `timeout` integer
- `api-version` string, required

## Headers

- `client-request-id` string
- `return-client-request-id` boolean
- `ocp-date` string, date-time-rfc1123

## Response `200`

Gets the list of certificates.

- CertificateListResult — Response to a CertificateOperations.List request.
  - `value` Certificate[] — Gets or sets the list of certificates.
    - `thumbprint` string — Get or sets the X.509 thumbprint of the certificate. This is a sequence of up to 40 hex digits (it may include spaces but these are removed).
    - `thumbprintAlgorithm` string — Gets or sets the algorithm used to derive the thumbprint. This must be sha1.
    - `url` string — Gets or sets the URL of the certificate.
    - `state` 'active' | 'deleting' | 'deletefailed' — Gets or sets the current state of the certificate.
    - `stateTransitionTime` string, date-time — Gets or sets the time at which the certificate entered its current state.
    - `previousState` 'active' | 'deleting' | 'deletefailed' — Gets or sets the previous state of the certificate. This property is not set if the certificate is in its initial Active state.
    - `previousStateTransitionTime` string, date-time — Gets or sets the time at which the certificate entered its previous state. This property is not set if the certificate is in its initial Active state.
    - `publicData` string — Gets or sets the public part of the certificate as a base-64 encoded .cer file.
    - `deleteCertificateError` DeleteCertificateError — An error encountered by the Batch service when deleting a certificate.
      - `code` string — Gets or sets an identifier for the certificate deletion error. Codes are invariant and are intended to be consumed programmatically.
      - `message` string — Gets or sets a message describing the certificate deletion error, intended to be suitable for display in a user interface.
      - `values` NameValuePair[] — Gets or sets a list of additional error details related to the certificate deletion error.
        - `name` string — Gets or sets the name in the name-value pair.
        - `value` string — Gets or sets the value in the name-value pair.
  - `odata.nextLink` string — Gets or sets the URL to get the next set of results.

## Other responses

- `default` — Error from the Batch service

---

[API](https://skmtc.dev/azure/apis/batch-batch.md) · [All operations](https://skmtc.dev/azure/apis/batch-batch/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/batch-batch/revisions/d7960a570e92/schema)