---
title: "Transformer Damage"
method: POST
path: "/api/v1/tools/transformer/damage"
tags: ["ferramentas"]
---

# Transformer Damage

`POST /api/v1/tools/transformer/damage`

## Request

- Base URL: `https://app.estudoseletricos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.estudoseletricos.com/api/v1/tools/transformer/damage`
- Auth: none declared

## Request body

- TrafoDanoIn: Curva de dano do transformador (IEEE C57.109) — `study_transformer_damage`. A categoria sai da potência; a curva MECÂNICA só existe em faltas frequentes das categorias II a IV, que é o que a norma prevê.
  - `Sn_kVA` number, required: potência nominal (kVA)
  - `Vn_kV` number, required: tensão do enrolamento em estudo (kV)
  - `Z_pct` number, required: impedância de curto-circuito Z (%)
  - `phases` '3ph' | '1ph'
  - `fault_frequency` 'infrequent' | 'frequent': frequente = mais de 10 faltas passantes na vida
  - `transformer_type` 'liquid' | 'dry'
  - `k_inrush` number: múltiplo de In no inrush
  - `t_inrush_ms` number
  - `connection` 'none' | 'dyg' | 'ygd' | 'dd' | 'yy' | 'ygyg': ligação primário–secundário (C37.91): desloca a curva referida ao outro lado — Δ-Yg ×0,58 · Δ-Δ/Y-Y ×0,87
  - `referida` boolean: a curva referida ao outro lado
  - `inrush_pico` boolean: o inrush de pico (25×In em 10 ms)
  - `ponto_fla` boolean: a corrente nominal a 1000 s
  - `figura` boolean: a curva em PNG, do MESMO gerador do memorial

## Response `200`

Successful Response

- TrafoDanoOut
  - `Sn_kVA` number, required
  - `Vn_kV` number, required
  - `Z_pct` number, required
  - `phases` string, required
  - `category` string, required: I a IV — pela potência (C57.109 Tab. 1)
  - `fault_frequency` string, required
  - `transformer_type` string, required
  - `In_kA` number, required
  - `I_max_pu` number, required: corrente passante máxima, em múltiplos de In
  - `I_max_kA` number, required
  - `mech_break_kA` number, nullable: joelho da curva mecânica; None quando ela não se aplica
  - `k_inrush` number, required
  - `ansi_point` PontoOut, required
    - `nome` string, required
    - `I_kA` number, required
    - `t_ms` number, required
  - `inrush_point` PontoOut, required
    - `nome` string, required
    - `I_kA` number, required
    - `t_ms` number, required
  - `curvas` CurvaOut[], required: dano (governante), térmica e — quando aplicável — mecânica
    - `nome` string, required
    - `I_kA` number[], required
    - `t_ms` number[], required
  - `fator_ligacao` number: deslocamento da ligação (C37.91)
  - `referida` ReferidaOut: A curva de dano referida ao OUTRO lado do transformador pela ligação (C37.91): o núcleo desloca só a corrente — a razão de transformação cancela ao referir.
    - `ligacao` string, required
    - `fator` number, required
    - `I_max_kA` number, required
    - `mech_break_kA` number, nullable
    - `ansi_point` PontoOut, required
      - `nome` string, required
      - `I_kA` number, required
      - `t_ms` number, required
    - `curva` CurvaOut, required: Uma curva no plano I×t do coordenograma: corrente em kA, tempo em ms (a MESMA convenção da folha TCC da plataforma).
      - `nome` string, required
      - `I_kA` number[], required
      - `t_ms` number[], required
  - `pontos` PontoOut[]: o inrush de pico e o FLA, quando pedidos
    - `nome` string, required
    - `I_kA` number, required
    - `t_ms` number, required
  - `complementos_fora` string[]: COBERTURA: o complemento pedido que não se aplica, e por quê
  - `figura_png_b64` string, nullable: a curva em PNG — a do memorial
  - `avisos` string[]
  - `norma` string
  - `tier` string: anon · free · full

## Other responses

- `422`: entrada recusada pela C57.109
- `429`: teto de chamadas

---

[API](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api.md) · [All operations](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api/revisions/5877d717cb1b?raw)