---
title: "List certificates."
method: GET
path: "/tyk/certs"
tags: ["Certs"]
---

# List certificates.

`GET /tyk/certs`

List all certificates in the Tyk Gateway.

## Query parameters

- `org_id` string
- `mode` 'detailed'

## Response `200`

OK

- union
  - APIAllCertificateBasics
    - `certs` CertsCertificateBasics[], nullable
      - `dns_names` string[], nullable
      - `has_private` boolean
      - `id` string
      - `is_ca` boolean
      - `issuer_cn` string
      - `not_after` string, date-time
      - `not_before` string, date-time
      - `subject_cn` string
  - APIAllCertificates
    - `certs` string[], nullable

## Other responses

- `403` — Forbidden

## 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`
  - …6 more
- **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/format changed from `boolean`/`` to `string`/`` for status `200`
  - …5 more

[Change history](https://skmtc.dev/tyktechnologies/apis/tyk-gateway-api/changes/tyk/certs/get.md)

---

[API](https://skmtc.dev/tyktechnologies/apis/tyk-gateway-api.md) · [All operations](https://skmtc.dev/tyktechnologies/apis/tyk-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tyktechnologies/tyk-gateway-api/revisions/900d0a33ae1d/schema)