---
title: "List"
method: GET
path: "/certificate_authorities"
tags: ["CertificateAuthorities"]
---

# List

`GET /certificate_authorities`

List all Certificate Authority on this account

## Query parameters

- `before_id` string
- `limit` string
- `filter` string

## Headers

- `ngrok-version` integer, required

## Response `200`

List all Certificate Authority on this account

- CertificateAuthorityList
  - `certificate_authorities` CertificateAuthority[] — the list of all certificate authorities on this account
    - `id` string — unique identifier for this Certificate Authority
    - `uri` string — URI of the Certificate Authority API resource
    - `created_at` string — timestamp when the Certificate Authority was created, RFC 3339 format
    - `description` string — human-readable description of this Certificate Authority. optional, max 255 bytes.
    - `metadata` string — arbitrary user-defined machine-readable data of this Certificate Authority. optional, max 4096 bytes.
    - `ca_pem` string — raw PEM of the Certificate Authority
    - `subject_common_name` string — subject common name of the Certificate Authority
    - `not_before` string — timestamp when this Certificate Authority becomes valid, RFC 3339 format
    - `not_after` string — timestamp when this Certificate Authority becomes invalid, RFC 3339 format
    - `key_usages` string[] — set of actions the private key of this Certificate Authority can be used for
    - `extended_key_usages` string[] — extended set of actions the private key of this Certificate Authority can be used for
  - `uri` string — URI of the certificates authorities list API resource
  - `next_page_uri` string — URI of the next page, or null if there is no next page

## Other responses

- `4XX` — An error. The body carries a machine-readable error_code and a human-readable msg; every code is documented at https://ngrok.com/docs/errors. A 429 with error code ERR_NGROK_226 means the account exceeded the documented request-rate limit.
- `5XX` — An error. The body carries a machine-readable error_code and a human-readable msg; every code is documented at https://ngrok.com/docs/errors. A 429 with error code ERR_NGROK_226 means the account exceeded the documented request-rate limit.

## Changes

- **2025-12-16** `602cd080d3a7` — 1 info
  - added the new optional `query` request parameter `filter`

[Change history](https://skmtc.dev/ngrok/apis/ngrok-openapi/changes/certificate_authorities/get.md)

---

[API](https://skmtc.dev/ngrok/apis/ngrok-openapi.md) · [All operations](https://skmtc.dev/ngrok/apis/ngrok-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ngrok/ngrok-openapi/revisions/c697539ac350/schema)