---
title: "Cable Size"
method: POST
path: "/api/v1/tools/cable/size"
tags: ["ferramentas"]
---

# Cable Size

`POST /api/v1/tools/cable/size`

## 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/cable/size`
- Auth: none declared

## Request body

- CableIn: Dimensionamento de cabo BT (NBR 5410) — os argumentos de `tools_core.cable_sizing.size_cable`, com os mesmos defaults.
  - `P_W` number, required: potência do circuito (W)
  - `V_V` number, required: tensão entre fases (2F/3F) ou fase-neutro (1FN), em V
  - `system` '1FN' | '2F' | '3F' | '3FN': 1FN monofásico · 2F bifásico · 3F trifásico · 3FN com neutro
  - `pf` number: fator de potência
  - `length_m` number
  - `method` string: método de referência (A1…G) — Tab. 33
  - `insulation` 'PVC' | 'EPR'
  - `material` 'Cu' | 'Al'
  - `ambient_C` number: temperatura ambiente (°C)
  - `n_circuits` integer
  - `arrangement` string: agrupamento — Tab. 42
  - `n_parallel` integer: condutores por fase
  - `circuit_type` 'forca' | 'iluminacao' | 'sinalizacao'
  - `In_A` number, nullable: corrente nominal do disjuntor; None = escolhe
  - `curve` 'B' | 'C' | 'D'
  - `familia_protecao` 'mcb' | 'mccb' | 'acb' | 'fuse' | 'rele', nullable: família da proteção do circuito; omitido mantém a régua de MCB
  - `icc_board_kA` number: Icc presumida no quadro
  - `with_neutral` boolean
  - `allow_reduced_neutral` boolean
  - `max_dv_pct` number: queda de tensão admissível (%)
  - `f_variant` string
  - `g_orientation` string
  - `Ib_A` number, nullable: corrente de projeto; None = de P/V/fp
  - `hours_year` number: horas/ano sob Ib — contínuo 8760; 1 turno ≈ 2200
  - `tariff_kwh` number, nullable: R$/kWh — sem ela a perda sai em energia, e o estudo cala sobre dinheiro
  - `figura` boolean: o gráfico banda × dano, do MESMO gerador do memorial

## Response `200`

Successful Response

- CableOut: O resultado de `size_cable` — os campos que a tela e o memorial imprimem.
  - `Ib_A` number, required
  - `In_A` number, nullable
  - `ft` number, required: fator de temperatura (Tab. 40)
  - `fg` number, required: fator de agrupamento (Tab. 42)
  - `Iz_req_A` number, required
  - `section_mm2` number, required
  - `Iz_total_A` number, required
  - `limited_by` string, required: ampacidade · queda de tensão · seção mínima…
  - `n_loaded` integer, required
  - `dv_V` number, required
  - `dv_pct` number, required
  - `dv_limit_pct` number, required
  - `coord_rule1_ok` boolean, nullable: Ib ≤ In ≤ Iz (§5.3.4.1)
  - `I2_A` number, nullable
  - `coord_rule2_ok` boolean, nullable: I2 ≤ 1,45·Iz
  - `neutral_mm2` number, nullable
  - `pe_mm2` number, nullable
  - `eletroduto` EletrodutoOut: O eletroduto escolhido (Tab. 30) — a tupla (DN, polegadas, área) do núcleo.
    - `dn_mm` integer, required
    - `polegadas` string, required
    - `area_util_mm2` number, required
  - `cables_area_mm2` number, nullable
  - `occupation_pct` number, nullable
  - `occupation_limit_pct` number, nullable
  - `icc_min_A` number, nullable
  - `imag_max_A` number, nullable
  - `mag_ok` boolean, nullable
  - `k_adiab` integer, nullable
  - `i2t_max_A2s` number, nullable
  - `candidatos` CandidatoOut[]
    - `section_mm2` number, required
    - `Iz_base_A` number, required
    - `Iz_total_A` number, required
    - `ok_ampacity` boolean, required
    - `dv_pct` number, nullable
    - `ok_dv` boolean, nullable
  - `perdas` PerdasCaboOut: A perda por efeito Joule (I²R) nos condutores de fase a Ib e o custo anual (C75). R à temperatura máxima da isolação — conservador; sem neutro/PE nem perdas dielétricas.
    - `n_conductors` integer, required
    - `R_phase_ohm` number, required
    - `P_loss_W` number, required
    - `hours_year` number, required
    - `E_year_kWh` number, required
    - `cost_year` number, nullable: nulo sem a tarifa
    - `tariff` number, nullable
  - `t_dano_s` number, nullable: tempo até o dano adiabático à corrente de falta de fim de linha
  - `t_dano_adiabatico` boolean, nullable: t ≤ 5 s — a validade do critério k²S² (§5.3.5.5.2)
  - `figura_png_b64` string, nullable: banda do MCB × dano k²S² — a figura do memorial
  - `complementos_fora` string[]: COBERTURA: o complemento que não se aplica
  - `avisos` string[]
  - `norma` string
  - `tier` string: anon · free · full

## Other responses

- `422`: entrada recusada pela NBR 5410 (erro nomeado)
- `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)