---
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 CertificateOperation.List request.
  - `value` Certificate[] — The list of certificates.
    - `thumbprint` string — 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 — The algorithm used to derive the thumbprint. This must be sha1.
    - `url` string — The URL of the certificate.
    - `state` 'active' | 'deleting' | 'deletefailed' — The current state of the certificate.
    - `stateTransitionTime` string, date-time — The time at which the certificate entered its current state.
    - `previousState` 'active' | 'deleting' | 'deletefailed' — The previous state of the certificate. This property is not set if the certificate is in its initial Active state.
    - `previousStateTransitionTime` string, date-time — 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 — 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 — An identifier for the certificate deletion error. Codes are invariant and are intended to be consumed programmatically.
      - `message` string — A message describing the certificate deletion error, intended to be suitable for display in a user interface.
      - `values` NameValuePair[] — A list of additional error details related to the certificate deletion error.
        - `name` string — The name in the name-value pair.
        - `value` string — The value in the name-value pair.
  - `odata.nextLink` string — The URL to get the next set of results.

## Other responses

- `default` — The 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/bee2d837bf8f/schema)