---
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, required
- `mode` string
- `certID` string

## Response `200`

List of all Certificates

- union
  - APIAllCertificates — APIAllCertificates represents a list of certificates
    - `certs` string[]
  - APIAllCertificateBasics — APIAllCertificates represents a list of certificate basics
    - `certs` CertificateBasics[]
      - `id` string
      - `issuer_cn` string
      - `subject_cn` string
      - `dns_names` string[]
      - `has_private` string
      - `not_before` string
      - `not_after` string
  - CertificateMeta[]
    - `id` string
    - `fingerprint` string
    - `has_private` string
    - `issuer` PkixName — Name represents an X.509 distinguished name
      - `Country` string[]
      - `Organization` string[]
      - `OrganizationalUnit` string[]
      - `Locality` string[]
      - `Province` string[]
      - `StreetAddress` string[]
      - `PostalCode` string[]
      - `SerialNumber` string
      - `CommonName` string
      - `Names` PkixAttributeTypeAndValue[]
        - `Type` integer[]
        - `Value` object
      - `ExtraNames` PkixAttributeTypeAndValueSET[]
        - `Type` integer[]
        - `Value` array[]
          - PkixAttributeTypeAndValue[]
            - `Type` integer[]
            - `Value` object
    - `subject` PkixName — Name represents an X.509 distinguished name
      - `Country` string[]
      - `Organization` string[]
      - `OrganizationalUnit` string[]
      - `Locality` string[]
      - `Province` string[]
      - `StreetAddress` string[]
      - `PostalCode` string[]
      - `SerialNumber` string
      - `CommonName` string
      - `Names` PkixAttributeTypeAndValue[]
        - `Type` integer[]
        - `Value` object
      - `ExtraNames` PkixAttributeTypeAndValueSET[]
        - `Type` integer[]
        - `Value` array[]
          - PkixAttributeTypeAndValue[]
            - `Type` integer[]
            - `Value` object
    - `not_before` string
    - `not_after` string
    - `dns_names` string[]

## Changes

- **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`
  - …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/abb30dca1f8d/schema)