---
title: "List all CA certificates"
url: "https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-configuration-0/versions/af18902c-58f1-49d7-8ec2-9987b4e0d1bd/operations/list-ca_certificates"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-configuration-0/versions/af18902c-58f1-49d7-8ec2-9987b4e0d1bd.md

# List all CA certificates

`GET` `/runtime-groups/{runtimeGroupId}/core-entities/ca_certificates`

Operation ID: `list-ca_certificates`

Retrieve a list of all available Certificate Authority (CA) certificates, including the certificate ID, creation date, and other details. You can use query parameters to filter the results by size or tags, for example `/ca-certificates?size=50&tags=enterprise`.

## Path parameters

- `runtimeGroupId` (string, required) - The ID of your runtime group. This variable is available in the Konnect manager

## Query parameters

- `size` (integer, optional) - Number of resources to be returned.
- `offset` (string, optional) - Offset from which to return the next set of resources. Use the value of the 'offset' field from the response of a list operation as input here to paginate through all the resources
- `tags` (string, optional) - A list of tags to filter the list of resources on. Multiple tags can be concatenated using ',' to mean AND or using '/' to mean OR.

## Responses

- `200` - A successful response listing CA Certificates

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Konnect Runtime Groups Configuration
  version: 0.0.1
servers:
  - url: https://us.api.konghq.com/v2
    description: United-States Production region
  - url: https://eu.api.konghq.com/v2
    description: Europe Production region
  - url: https://au.api.konghq.com/v2
    description: Australia Production region
  - url: https://me.api.konghq.com/v2
    description: Middle-East Production region
  - url: https://in.api.konghq.com/v2
    description: India Production region
  - url: https://sg.api.konghq.com/v2
    description: Singapore Production region
paths:
  /runtime-groups/{runtimeGroupId}/core-entities/ca_certificates:
    parameters:
      - $ref: "#/components/parameters/runtimeGroupId"
    get:
      operationId: list-ca_certificates
      summary: List all CA certificates
      description: Retrieve a list of all available Certificate Authority (CA)
        certificates, including the certificate ID, creation date, and other
        details. You can use query parameters to filter the results by size or
        tags, for example `/ca-certificates?size=50&tags=enterprise`.
      parameters:
        - $ref: "#/components/parameters/pagination-size"
        - $ref: "#/components/parameters/pagination-offset"
        - $ref: "#/components/parameters/pagination-tags-filter"
      responses:
        "200":
          description: A successful response listing CA Certificates
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/CA-Certificate"
      tags:
        - CA Certificates
security:
  - konnectAccessToken: []
  - personalAccessToken: []
components:
  parameters:
    runtimeGroupId:
      name: runtimeGroupId
      in: path
      required: true
      schema:
        type: string
        example: 9524ec7d-36d9-465d-a8c5-83a3c9390458
      description: The ID of your runtime group. This variable is available in the
        Konnect manager
    pagination-size:
      description: Number of resources to be returned.
      in: query
      name: size
      schema:
        type: integer
        default: 100
        maximum: 1000
        minimum: 1
    pagination-offset:
      description: Offset from which to return the next set of resources. Use the
        value of the 'offset' field from the response of a list operation as
        input here to paginate through all the resources
      in: query
      name: offset
      schema:
        type: string
    pagination-tags-filter:
      description: A list of tags to filter the list of resources on. Multiple tags
        can be concatenated using ',' to mean AND or using '/' to mean OR.
      example: tag1,tag2
      in: query
      name: tags
      schema:
        type: string
  schemas:
    CA-Certificate:
      description: A CA certificate object represents a trusted CA. These objects are
        used by Kong to verify the validity of a client or server certificate.
        CA Certificates can be both tagged and filtered by tags.
      type: object
      properties:
        cert:
          description: PEM-encoded public certificate of the CA.
          type: string
          example: -----BEGIN CERTIFICATE-----...
        cert_digest:
          description: SHA256 hex digest of the public certificate.
          type: string
          example: c641e28d77e93544f2fa87b2cf3f3d51...
        created_at:
          description: Unix epoch when the resource was created.
          type: integer
          example: 1422386534
        updated_at:
          description: Unix epoch when the resouce was updated.
          type: integer
          example: 1422386534
        id:
          type: string
          format: uuid
          example: 04fbeacf-a9f1-4a5d-ae4a-b0407445db3f
        tags:
          description: An optional set of strings associated with the Certificate for
            grouping and filtering.
          type: array
          items:
            type: string
            example: "[user-level, low-priority]"
      example:
        cert: |-
          -----BEGIN CERTIFICATE-----
          certificate-content
          -----END CERTIFICATE-----
        id: b2f34145-0343-41a4-9602-4c69dec2f260
      title: CA-Certificate
      x-examples:
        200 - list of multiple certificates:
          data:
            - id: 43429efd-b3a5-4048-94cb-5cc4029909bb
              created_at: 1422386534
              updated_at: 1422386534
              cert: -----BEGIN CERTIFICATE-----...
              cert_digest: c641e28d77e93544f2fa87b2cf3f3d51...
              tags:
                - user-level
                - low-priority
            - id: d26761d5-83a4-4f24-ac6c-cff276f2b79c
              created_at: 1422386534
              updated_at: 1422386534
              cert: -----BEGIN CERTIFICATE-----...
              cert_digest: c641e28d77e93544f2fa87b2cf3f3d51...
              tags:
                - admin
                - high-priority
                - critical
          next: http://localhost:8001/ca_certificates?offset=6378122c-a0a1-438d-a5c6-efabae9fb969
  securitySchemes:
    konnectAccessToken:
      type: http
      scheme: bearer
      description: >-
        The Konnect access token is meant to be used by the Konnect dashboard
        and the decK CLI to

        authenticate with.
    personalAccessToken:
      type: http
      scheme: bearer
      description: The personal access token is meant to be used as an alternative to
        basic-auth when accessing Konnect via APIs. You can generate a Personal
        Access Token (PAT) from the personal access token page in the Konnect
        dashboard.
```
