---
title: "Changes to List certificates."
method: GET
path: "/tyk/certs"
---

# Changes to List certificates.

`GET /tyk/certs`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 54 revisions.

- **2024-09-18** `111affa17abe`: 5 breaking, 1 warning, 4 info
- **2024-07-12** `0a31cb35d1d9`: 2 info
- **2022-05-24** `111d8ca21864`: 6 breaking, 1 warning, 2 info

## Changes

- **2024-09-18** `111affa17abe`: 5 breaking, 1 warning, 4 info
  - the `query` request parameter `mode` was restricted to a list of enum values
  - the response property `oneOf[#/components/schemas/APIAllCertificateBasics]/certs` became nullable for the status `200`
  - the response property `oneOf[#/components/schemas/APIAllCertificateBasics]/certs/items/dns_names` became nullable for the status `200`
  - the response property `oneOf[#/components/schemas/APIAllCertificates]/certs` became nullable for the status `200`
  - the `oneOf[#/components/schemas/APIAllCertificateBasics]/certs/items/has_private` response's property type changed from `string` to `boolean` for status `200`
  - deleted the `query` request parameter `certID`
  - the `query` request parameter `org_id` became optional
  - added the new enum value `detailed` to the `query` request parameter `mode`
  - removed `subschema #3` from the response body `oneOf` list for the response status `200`
  - added the non-success response with the status `403`
- **2024-07-12** `0a31cb35d1d9`: 2 info
  - added the optional property `oneOf[#/components/schemas/APIAllCertificateBasics]/certs/items/is_ca` to the response with the `200` status
  - added the optional property `oneOf[subschema #3]/items/is_ca` to the response with the `200` status
- **2022-05-24** `111d8ca21864`: 6 breaking, 1 warning, 2 info
  - the `query` request parameter `org_id` became required
  - removed the enum value `detailed` from the `query` request parameter `mode`
  - added `subschema #3` to the response body `oneOf` list for the response status `200`
  - the `oneOf[#/components/schemas/APIAllCertificateBasics]/certs/items/has_private` response's property type changed from `boolean` to `string` for status `200`
  - the `oneOf[#/components/schemas/APIAllCertificateBasics]/certs/items/not_after` response's property format changed from `date-time` to no format for status `200`
  - the `oneOf[#/components/schemas/APIAllCertificateBasics]/certs/items/not_before` response's property format changed from `date-time` to no format for status `200`
  - removed the optional property `oneOf[#/components/schemas/APIAllCertificateBasics]/certs/items/is_ca` from the response with the `200` status
  - added the new optional `query` request parameter `certID`
  - removed the non-success response with the status `403`

---

[Operation](https://skmtc.dev/tyktechnologies/apis/tyk-gateway-api/docs/tyk/certs/get.md) - [API](https://skmtc.dev/tyktechnologies/apis/tyk-gateway-api.md) - [Page](https://skmtc.dev/tyktechnologies/apis/tyk-gateway-api/changes/tyk/certs/get)