# Get CA certificates

Retrieve the CA certificates stored on the system as a paginated JSON report.
Requires a token with **administrator** privileges.
Filtering parameters are modeled as query parameters (the documentation lists them as "in the request body",
but for HTTP GET they are typically passed as query parameters).

Endpoint: GET /admin/certificates/
Version: 1.0
Security: AuthToken

## Security:

  - `AuthToken` (unknown)
    apiKey in header Authorization

## Query parameters:

  - `page` (integer)
    Page number (pagination)

  - `where_subject` (string)
    Filter by any string in the certificate Subject

  - `where_issuer` (string)
    Filter by any string in the certificate Issuer

  - `where_cert_id` (string)
    Filter by any string in the Certificate ID

  - `where_serial_number` (string)
    Filter by any string in the Certificate SerialNumber

  - `where_not_before` (string)
    Minimum validity date (ISO 8601)

  - `where_not_after` (string)
    Maximum validity date (ISO 8601)

  - `where_tags` (string)
    Filter by tags associated with the certificate

## Response 200:

  - `200` (unknown)
    Paginated list of CA certificates

## Response 200 fields (application/json):

  - `pagination` (object)

  - `pagination.count` (integer)

  - `pagination.next` (string)

  - `pagination.page` (integer)

  - `pagination.pages` (integer)

  - `pagination.previus` (string)

  - `meta` (object)

  - `meta.status` (string)
    Example: 200 OK

  - `data` (array)

  - `data.hash` (string)

  - `data.certificate` (string)

  - `data.tags` (object)

  - `data.not_before` (object)

  - `data.not_before.option` (string)
    ASN.1 time option (GENERAL_TIME or UTC_TIME)
    Example: UTC_TIME

  - `data.not_before.utc` (boolean)
    True if time is UTC-based

  - `data.not_before.value` (string)
    ISO 8601 datetime
    Example: 2043-06-05T17:35:47

  - `data.cert_id` (string)

  - `data.serial_number` (string)

  - `data.subject` (string)

  - `data.issuer` (string)

## Response 401:

  - `401` (unknown)
    Unauthorized (invalid or missing token)

## Response 401 fields (application/json):

  - `title` (string)

  - `description` (string)

  - `code` (string)

  - `message` (string)

## Response 502:

  - `502` (unknown)
    Upstream/service error (HTML body)

## Response 401 examples:

  - `invalidToken` (unknown)

