---
title: "List all certificates"
method: GET
path: "/gateway_manager/v1/certificates"
tags: ["Gateway Manager"]
---

# List all certificates

`GET /gateway_manager/v1/certificates`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/gateway_manager/v1/certificates`
- Auth: none declared

Returns all certificates from the certificate store.

## Response `200`

A list of all of the certificates that exist in the certificate store

- GatewayManagerGetCertificatesResponse200
  - `state` string
  - `results` GatewayManagerV1CertificatesGetResponsesContentApplicationJsonSchemaResultsItems[]
    - `_id` string: The Id of the certificate within the database
    - `certificate` string: The raw certificate data
    - `contract_id` string: The name of the certificate
    - `host` string
    - `issuer` string
    - `self_signed` boolean
    - `type` string
    - `validity` GatewayManagerV1CertificatesGetResponsesContentApplicationJsonSchemaResultsItemsValidity
      - `notBefore` string, date-time
      - `notAfter` string, date-time
    - `gateways` string[]: An array of the gateways that are associated with the certificate

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Gateway Manager` added
  - api tag `gatewayManager` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/gateway_manager/v1/certificates/get.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)