Share via


Get Certificate Issuers - Get Certificate Issuers

List certificate issuers for a specified key vault.
The GetCertificateIssuers operation returns the set of certificate issuer resources in the specified key vault. This operation requires the certificates/manageissuers/getissuers permission.

GET {vaultBaseUrl}/certificates/issuers?api-version=2025-07-01
GET {vaultBaseUrl}/certificates/issuers?api-version=2025-07-01&maxresults={maxresults}

URI Parameters

Name In Required Type Description
vaultBaseUrl
path True

string (uri)

api-version
query True

string

minLength: 1

The API version to use for this operation.

maxresults
query

integer (int32)

minimum: 1
maximum: 25

Maximum number of results to return in a page. If not specified the service will return up to 25 results.

Responses

Name Type Description
200 OK

CertificateIssuerListResult

The request has succeeded.

Other Status Codes

KeyVaultError

An unexpected error response.

Security

OAuth2Auth

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
https://vault.azure.net/.default

Examples

GetCertificateIssuers

Sample request

GET https://myvault.vault.azure.net//certificates/issuers?api-version=2025-07-01

Sample response

{
  "value": [
    {
      "id": "https://myvault.vault.azure.net/certificates/issuers/issuer01",
      "provider": "Test"
    },
    {
      "id": "https://myvault.vault.azure.net/certificates/issuers/issuer02",
      "provider": "Test"
    },
    {
      "id": "https://myvault.vault.azure.net/certificates/issuers/issuer03",
      "provider": "Test"
    }
  ],
  "nextLink": null
}

Definitions

Name Description
CertificateIssuerItem

The certificate issuer item containing certificate issuer metadata.

CertificateIssuerListResult

The certificate issuer list result.

Error
KeyVaultError

The key vault error exception.

CertificateIssuerItem

The certificate issuer item containing certificate issuer metadata.

Name Type Description
id

string

Certificate Identifier.

provider

string

The issuer provider.

CertificateIssuerListResult

The certificate issuer list result.

Name Type Description
nextLink

string

The URL to get the next set of certificate issuers.

value

CertificateIssuerItem[]

A response message containing a list of certificate issuers in the key vault along with a link to the next page of certificate issuers.

Error

Name Type Description
code

string

The error code.

innererror

Error

The key vault server error.

message

string

The error message.

KeyVaultError

The key vault error exception.

Name Type Description
error

Error

The key vault server error.