List Certificates.

Return list of certificates. If you send the mode query parameter with the value detailed the certificates returned will have more information (Will contains all certs basic details). To retrieve a list with complete certificate details use this endpoint. If the mode query parameter is omitted or is empty this endpoint will only return the certificates IDs. The list of certificates returned is paginated.

GET /api/certs

Try it

List Certificates.

cURL

curl --request GET \
  --url https://{tenant}/api/certs \
  --header 'Authorization: Bearer <token>'

200

detailed_mode

{
  "cert_basics": [
    {
      "dns_names": [
        ".*itachi.io"
      ],
      "has_private": false,
      "id": "5e9d9544a1dcd60001d0ed208edce514c2d0a866063550c64d6c90be99d01561ac5aa7e82b8610b7e273d37d",
      "is_ca": false,
      "issuer_cn": "tyk-gateway-2.localhost",
      "not_after": "2025-05-19T05:23:10Z",
      "not_before": "2024-05-19T05:23:10Z",
      "subject_cn": "tyk-gateway-2.localhost"
    },
    {
      "dns_names": [
        ".*tyk.io"
      ],
      "has_private": false,
      "id": "5e9d9544a1dcd60001d0ed207c440d66ebb0a4629d21329808dce9091acf5f2fde328067a6e60e5347271d90",
      "is_ca": false,
      "issuer_cn": "tyk.io",
      "not_after": "2034-03-26T08:46:37Z",
      "not_before": "2024-03-25T08:46:37Z",
      "subject_cn": "tyk.io"
    }
  ],
  "pages": 1
}

Authorizations

Authorization · string · header · required

The Tyk Dashboard API Access Credentials

Query Parameters

p · integer

Use p query parameter to say which page you want returned. Send number less than 0 to return all items.

mode · enum<string>

Set to detailed to get certificates that are more with more details (Will contains certs basic details). To retrieve a list of certificates with all the certificate details use this endpoint.

Available options: detailed

filter · enum<string> · default: omit

Used to apply filtering to the list of certificates returned in the response. With this option you are able to filter by certificates that can be used when signing a request (i.e. they contain a private key), or those used to validate a signature (i.e. they do not contain a private key, only the public key). This query param works only in combination with detailed mode (mode=detailed). omit (default) – Returns all certificates. with_pk – Returns only certificates that include a private key. without_pk – Returns only certificates that do not include a private key.

Available options: omit, with_pk, without_pk

Response

200

application/json

OK

Option 1

Option 2

cert_basics · object[] | null

Show child attributes

cert_basics. dns_names · string[] | null

cert_basics. has_private · boolean

cert_basics. id · string

cert_basics. is_ca · boolean

cert_basics. issuer_cn · string

cert_basics. not_after · string<date-time>

cert_basics. not_before · string<date-time>

cert_basics. subject_cn · string

pages · integer