Página de Status da API

Visão Geral#

A página de status da Pluggy em connector-status.pluggy.ai mostra a saúde ao vivo de cada conector, produto de pagamento e componente de infraestrutura, além do histórico de incidentes. Tudo que a página renderiza vem de um único snapshot JSON público que você pode consumir diretamente — sem autenticação necessária.

Se você só quer notificações, não precisa desta API: inscreva-se por e-mail na página de status, adicione o aplicativo Pluggy Status no Slack a um canal, ou use o feed RSS.

O endpoint do snapshot#

GET https://docs.pluggy.dev/api/status

• Sem autenticação. CORS está aberto, então você pode chamá-lo de um aplicativo de navegador.
• Cache por ~30 segundos. Faça polling a cada 60 segundos ou mais lento — polling mais rápido apenas lê o cache novamente.

A resposta contém quatro coleções:

Instituições#

{
  "pluggy_id": "601",
  "name": "Itaú",
  "type": "PERSONAL_BANK",
  "logo_url": "https://cdn.pluggy.ai/assets/connector-icons/201.svg",
  "status": "online",
  "bars": "ooooooo…dxo",
  "uptime": 99.51,
  "supports_data": true,
  "supports_pis": true,
  "supports_pis_scheduled": true,
  "supports_pix_auto": true,
  "supports_smart_transfer": true
}

• pluggy_id é o mesmo id do conector que você usa em outros lugares na API da Pluggy — faça a correspondência diretamente.
• status é um dos online, degraded, offline, maintenance.
• bars codifica os últimos 90 dias como um caractere por dia, do mais antigo para o mais recente: o online, d degradado, p interrupção parcial, x offline, m manutenção.
• uptime é uma porcentagem ponderada de 90 dias (dias degradados contam 25% de inatividade, parciais 50%, offline 100%).
• As flags supports_* informam quais produtos a instituição oferece (dados, iniciação de pagamento, pagamentos agendados, PIX automático, transferências inteligentes).

Exemplo — ver a saúde de um conector:

curl -s https://docs.pluggy.dev/api/status \
  | jq '.institutions[] | select(.pluggy_id == "601") | {name, status, uptime}'

Incidentes#

{
  "id": "4a8f1e80-…",
  "kind": "incident",
  "product": "pis",
  "pluggy_id": "612",
  "institution_name": "PagBank",
  "severity": "degraded",
  "state": "identified",
  "apis": ["Criação de pagamento"],
  "started_at": "2026-07-07T14:28:21Z",
  "resolved_at": null,
  "postmortem": null,
  "updates": [{ "state": "identified", "body": "…", "created_at": "…" }]
}

• Um incidente está aberto enquanto state != "resolved".
• product é um dos dados, pis, pis-agendado, pixauto, smart, infra (incidentes legados podem ter pagamentos, que mapeia para pis).
• kind é incident ou maintenance; manutenções têm window_starts_at / window_ends_at.
• Incidentes com escopo de conector incluem pluggy_id, então você pode juntá-los à sua própria lista de conectores.
• Cada incidente tem uma página compartilhável em https://connector-status.pluggy.ai/incident/<id>.

Exemplo — incidentes abertos que afetam um conector que você usa:

curl -s https://docs.pluggy.dev/api/status \
  | jq '.incidents[] | select(.state != "resolved" and .pluggy_id == "612") | {title, state, severity}'

Widget embutido#

Mostre o status ao vivo da Pluggy dentro do seu próprio aplicativo ou dashboard interno.

Badge flutuante — uma tag de script, renderiza uma pequena pílula (ponto de status + rótulo) no canto da página, vinculando à página de status. Atualiza a cada 60 segundos.

<script
  src="https://connector-status.pluggy.ai/widget.js"
  defer
  data-lang="en"
  data-position="bottom-right"
></script>

• data-lang: pt (padrão), es ou en.
• data-position: bottom-right (padrão) ou bottom-left.
• data-target: um seletor CSS — renderiza o badge inline dentro desse elemento em vez de flutuar.

Painel Iframe — um painel compacto com status geral, componentes de infraestrutura e incidentes abertos:

<iframe
  src="https://connector-status.pluggy.ai/embed?lang=en"
  width="360"
  height="240"
  style="border: 0"
  title="Pluggy Status"
></iframe>

Endpoint de resumo — ambos são suportados por um pequeno resumo JSON que você também pode consumir diretamente (CORS aberto, cache ~30s):

GET https://connector-status.pluggy.ai/api/widget

{
  "status": "op",
  "labels": { "pt": "…", "es": "…", "en": "Todos os sistemas operacionais" },
  "openIncidents": 0,
  "updatedAt": "2026-07-10T12:00:00.000Z"
}

status é op (operacional), mn (manutenção), dg (degradado), pt (interrupção parcial) ou mj (interrupção maior) — o pior entre conectores, produtos de pagamento e infraestrutura.

Outros canais#