---
title: "Battery Sizing"
method: POST
path: "/api/v1/tools/battery/sizing"
tags: ["ferramentas"]
---

# Battery Sizing

`POST /api/v1/tools/battery/sizing`

## 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/battery/sizing`
- Auth: none declared

## Request body

- BateriaIn: Banco de baterias (IEEE 485 / 1115) — `study_battery_sizing`. O ciclo de trabalho é a entrada: a capacidade sai da seção CONTROLADORA, não da soma.
  - `cargas` CargaCcIn[], required
    - `desc` string
    - `kind` 'continuous' | 'noncontinuous' | 'momentary'
    - `current_A` number, required: corrente da carga (A)
    - `t_start_min` number: início, em minutos
    - `duration_min` number, required: duração (min)
  - `cell` string: modelo da biblioteca do núcleo
  - `eodv_V` number, nullable: tensão final por célula
  - `temp_C` number: temperatura da sala (°C)
  - `design_margin` number: margem de projeto
  - `aging_factor` number, nullable: None = o default da química
  - `plate_type` 'M' | 'P': M = multi-placa
  - `v_sys_nom` number
  - `v_sys_max` number
  - `v_sys_min` number
  - `v_charge_per_cell` number, nullable: tensão de carga por célula (flutuação/equalização), que fixa o nº de células em série; nula = o padrão da QUÍMICA da célula (chumbo 2,33 · Ni-Cd 1,50 V/cél, os da plataforma). O 2,33 fixo dava 60 células Ni-Cd num barramento de 125 V, em vez de 93

## Response `200`

Successful Response

- BateriaOut
  - `chemistry` string, required
  - `cell_model` string, required
  - `eodv_V` number, required
  - `eodv_per_cell_V` number, required
  - `temp_C` number, required
  - `design_margin` number, required
  - `aging_factor` number, required
  - `plate_type` string, required
  - `k_temp` number, required
  - `k_design` number, required
  - `k_aging` number, required
  - `F_uncorr_Ah` number, required: capacidade da seção controladora, sem correções
  - `F_random_Ah` number, required: parcela da carga aleatória (momentânea)
  - `C_req_Ah` number, required: capacidade exigida, já corrigida
  - `C_cell_Ah` number, required
  - `n_series` integer, required: células em série pela janela de tensão CC
  - `v_charge_per_cell` number, required: a tensão de carga por célula usada — a informada ou a da química
  - `n_strings` integer, required
  - `C_bank_Ah` number, required
  - `window_ok` boolean, required: a janela de tensão fecha com esse nº de células
  - `ok` boolean, required
  - `controlling_section` integer, required
  - `periodos` PeriodoOut[]
    - `index` integer, required
    - `A_p` number, required: corrente do período (A)
    - `start_min` number, required
    - `end_min` number, required
  - `secoes` SecaoOut[]
    - `index` integer, required
    - `total_Ah` number, required
    - `n_linhas` integer, required
  - `avisos` string[]
  - `norma` string
  - `tier` string: anon · free · full

## Other responses

- `422`: ciclo ou célula recusados
- `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)