---
title: "Consultar histórico de saúde"
method: GET
path: "/health/history"
tags: ["Health"]
---

# Consultar histórico de saúde

`GET /health/history`

## Request

- Base URL: `https://api.signdocs.com.br`
- URL: `https://api.signdocs.com.br/health/history`
- Auth: none required

Retorna métricas históricas de disponibilidade da API, incluindo uptime por componente,
incidentes e a última verificação realizada.

## Query parameters

- `period` '24h' | '7d' | '30d'

## Response `200`

Histórico de saúde retornado com sucesso.

- HealthHistoryResponse: Resposta com histórico de saúde da API.
  - `period` '24h' | '7d' | '30d', required: Período consultado.
  - `from` string, date-time, required: Início do período.
  - `to` string, date-time, required: Fim do período.
  - `totalChecks` integer, required: Total de verificações no período.
  - `uptime` object, required: Percentual de disponibilidade por componente.
    - `overall` number: Uptime geral (0-100).
    - `dynamodb` number
    - `s3` number
    - `kms` number
    - `mtlsTruststore` number
  - `incidents` object[], required: Incidentes no período.
    - `startedAt` string, date-time, required
    - `endedAt` string, date-time
    - `affectedComponents` string[], required
    - `durationMinutes` number
  - `latestCheck` object: Última verificação realizada.
    - `overallStatus` string
    - `components` object
      - `dynamodb` ComponentHealth: Status de saúde de um componente individual.
        - `status` 'operational' | 'down', required: Status operacional do componente.
        - `latencyMs` number, required: Latência da verificação do componente em milissegundos.
      - `s3` ComponentHealth: Status de saúde de um componente individual.
        - `status` 'operational' | 'down', required: Status operacional do componente.
        - `latencyMs` number, required: Latência da verificação do componente em milissegundos.
      - `kms` ComponentHealth: Status de saúde de um componente individual.
        - `status` 'operational' | 'down', required: Status operacional do componente.
        - `latencyMs` number, required: Latência da verificação do componente em milissegundos.
      - `mtlsTruststore` ComponentHealth: Status de saúde de um componente individual.
        - `status` 'operational' | 'down', required: Status operacional do componente.
        - `latencyMs` number, required: Latência da verificação do componente em milissegundos.
    - `checkedAt` string, date-time
    - `totalLatencyMs` number

## Other responses

- `429`: Limite de requisições excedido.
- `500`: Erro interno do servidor.

---

[API](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api.md) · [All operations](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api/revisions/2d3805aed161?raw)