{
  "openapi": "3.1.0",
  "info": {
    "title": "Ulga na dziecko: limit dochodu i zwrot",
    "version": "2026",
    "description": "Ulga na dzieci w PIT za 2026 r. (art. 27f ustawy o PIT) dla rodziców na etacie: kwota odliczona od podatku, zwrot z urzędu skarbowego (najwyżej do sumy składek ZUS i zdrowotnej) i limit dochodu przy jednym dziecku (112000 zł dla małżonków razem i samotnie wychowujących, 56000 zł dla rodzica bez ślubu). Kwoty w zł rocznie. Pensje na etacie przez cały rok u jednego pracodawcy, standardowe koszty uzyskania przychodu, bez innych dochodów i ulg; dzieci małoletnie przez cały rok; bez wyjątku dla dziecka z niepełnosprawnością."
  },
  "servers": [
    {
      "url": "https://przeliczmy.pl"
    }
  ],
  "paths": {
    "/api/dziecko/ulga": {
      "get": {
        "operationId": "dzieckoUlga",
        "summary": "Ulga na dzieci: odliczenie, zwrot i limit dochodu",
        "parameters": [
          {
            "name": "brutto",
            "in": "query",
            "required": true,
            "schema": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000,
              "description": "Pensja brutto miesięcznie w zł"
            }
          },
          {
            "name": "brutto_drugie",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000,
              "default": 5000
            }
          },
          {
            "name": "dzieci",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10,
              "default": 1
            }
          },
          {
            "name": "sytuacja",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "malzenstwo",
                "samotnie",
                "bez_slubu"
              ],
              "default": "malzenstwo"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Wynik (kwoty w zł rocznie)",
            "content": {
              "application/json": {
                "example": {
                  "rok": 2026,
                  "sytuacja": "malzenstwo",
                  "dzieci": 1,
                  "brutto_miesiecznie": 6000,
                  "brutto_drugiego_rodzica_miesiecznie": 5000,
                  "dochod_do_limitu": 107904,
                  "limit_dochodu": 112000,
                  "ponad_limit": 0,
                  "zapas_do_limitu": 4096,
                  "limit_od_brutto": 6396,
                  "ulga_pelna": 1112.04,
                  "ulga_przysluguje": true,
                  "podatek_przed_ulga": 5749,
                  "odliczona_od_podatku": 1112.04,
                  "zwrot": 0,
                  "skladki_limit_zwrotu": 28348.56,
                  "ulga_razem": 1112.04,
                  "ulga_niewykorzystana": 0,
                  "strata_przez_limit": 0
                }
              }
            }
          },
          "400": {
            "description": "Błędne parametry"
          },
          "429": {
            "description": "Za dużo zapytań, spróbuj za minutę"
          }
        }
      }
    }
  }
}