ForHosting KIT · Finanzen und Geld

AGI

Ermitteln Sie das AGI, auf dem der Rest einer Steuererklärung aufbaut: 85.000 Bruttoeinkommen minus 2.500 Studienkreditzinsen und 6.500 IRA-Beiträge ergeben 76.000. Standardabzug und Steuergutschriften kommen erst danach und bleiben außen vor. Kostenlos in Ihrem Browser.

Kostenlos
Läuft in Ihrem Browser
Ohne Anmeldung
Ihre Daten bleiben auf Ihrem Gerät

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Der Rechner für das bereinigte Bruttoeinkommen nimmt Ihr Bruttoeinkommen und eine Liste von above-the-line-Abzügen — Studienkreditzinsen, IRA-Beiträge, Lehrkräfteaufwendungen, Einzahlungen auf Gesundheitssparkonten und ähnliche Posten — und liefert das AGI, das den Rest einer Steuererklärung trägt. Das AGI ist die Zahl, die über die Anspruchsberechtigung für Steuergutschriften, Abzugsgrenzen und viele Steuerberechnungen der Bundesstaaten entscheidet; es muss daher stimmen, bevor irgendetwas Folgendes berechnet wird. Derselbe deterministische Code läuft auf dieser Seite kostenlos in Ihrem Browser — Sie zahlen nur, wenn Sie ihn automatisieren.

Was das bereinigte Bruttoeinkommen wirklich ist

Das bereinigte Bruttoeinkommen ist keine Vermutung und keine Schätzung, sondern eine definierte Subtraktion. Ausgangspunkt ist das Bruttoeinkommen, also die Summe aller Einnahmen des Zeitraums: Löhne, Einkünfte aus selbstständiger Arbeit, Zinsen, Dividenden, Mieteinnahmen, Rentenauszahlungen und jeder andere steuerpflichtige Zufluss. Von dieser Summe erlauben die Steuerregeln eine bestimmte Liste von Abzügen, die above-the-line-Abzüge genannt werden, weil sie in der Erklärung vor der Zeile des bereinigten Bruttoeinkommens angesetzt werden und nicht danach.

Zu den häufigsten gehören Studienkreditzinsen, Beiträge zu traditionellen IRAs und zu Gesundheitssparkonten, der abzugsfähige Teil der Selbstständigensteuer, Lehrkräfteaufwendungen sowie Unterhaltszahlungen nach älteren Vereinbarungen. Was nach dem Abziehen übrig bleibt, ist das AGI. Der Rechner für das bereinigte Bruttoeinkommen führt genau diese Operation aus: Er nimmt den Bruttobetrag und die aufgeschlüsselten Abzüge, validiert jede Eingabe und liefert die Differenz.

Er wendet weder Standard- oder Einzelabzüge noch Regeln zum Familienstand oder Gutschriften an — all das kommt nach dem AGI, und es damit zu verwechseln ist der häufigste Fehler bei informellen Steuerrechnungen.

Wie die Berechnung und ihre Validierung funktionieren

Der Endpunkt akzeptiert zwei Felder: einen Bruttoeinkommensbetrag und ein Array von Abzugseinträgen, jeder mit einer Bezeichnung und einem Betrag. Sind die Eingaben gültig, liefert die Antwort das AGI, das Bruttoeinkommen, die Abzugssumme und die aufgeschlüsselte Liste wie empfangen, alles auf zwei Nachkommastellen gerundet, damit die Ausgabe maschinenübergreifend Byte für Byte stabil ist und sicher in einem Audit-Trail abgelegt werden kann.

Die Berechnung ist reine Arithmetik ohne Netzwerkaufrufe, ohne Zufall und ohne Uhr, sodass dieselbe Anfrage stets dieselbe Antwort erzeugt — eine Eigenschaft, die zählt, wenn ein Ergebnis Monate später bei einer Prüfung oder einem Audit reproduziert werden muss.

Wo das AGI in echten Arbeitsabläufen steht

Das AGI ist die Dreh- und Angelzahl einer Steuererklärung: Die Anspruchsberechtigung für Bildungsgutschriften, Roth-IRA-Beiträge, Prämiensteuergutschriften und viele Abzugsgrenzen wird als Schwelle über dem AGI oder dem modifizierten AGI ausgedrückt, das darauf aufbaut. Lohn- und Gehaltstools berechnen es neu, wenn ein Arbeitnehmer einen Beitrag vor Steuern anpasst; Formulare für Finanzhilfen fragen es wörtlich ab; Kreditgeber nutzen es als Plausibilitätsprüfung gegenüber dem angegebenen Einkommen.

Dieser Rechner ersetzt in solchen Abläufen eine Tabellenzelle durch einen validierten Vertrag: Der Aufrufer erhält entweder ein korrektes AGI oder einen klaren Fehler, der das fehlerhafte Feld benennt — niemals eine plausibel aussehende falsche Zahl. Da dasselbe Modul auf dieser Seite im Browser läuft, kann ein Entwickler genau die Nutzlast einfügen, die seine Integration senden wird, und das Ergebnis bestätigen, bevor er eine Zeile Code schreibt.

Anwendungsfälle

Anspruch auf Steuergutschriften abschätzen

Berechnen Sie zuerst das AGI und vergleichen Sie es dann mit den Schwellen der Bildungsgutschriften oder den Beitragsgrenzen für die Altersvorsorge.

Änderung eines Beitrags vor Steuern simulieren

Fügen Sie der Abzugsliste einen IRA- oder HSA-Beitrag hinzu oder entfernen Sie ihn und sehen Sie sofort, wie sich das AGI bewegt.

Häufige Fragen

Was kostet das?

Auf dieser Seite läuft derselbe Code außerdem kostenlos in Ihrem Browser — beide Antworten stammen aus derselben Berechnung.

Welche Abzüge zählen als above-the-line?

Posten wie Studienkreditzinsen, Beiträge zu traditionellen IRAs und HSAs, Lehrkräfteaufwendungen und der abzugsfähige Teil der Selbstständigensteuer. Das Tool akzeptiert jede Liste, die Sie übergeben; was zulässig ist, entscheidet Ihr Steuerberater.

Sind negative Beträge erlaubt?

Nein. Bruttoeinkommen und jeder Abzugsbetrag müssen endlich und größer oder gleich null sein.

Werden meine Einkommensdaten gespeichert?

Nein. Die Zahlen werden im Speicher verarbeitet und verworfen; nur das berechnete Ergebnis wird zurückgegeben.

Berechnet er Steuerschulden oder Erstattungen?

Nein. Er endet beim AGI. Zu versteuerndes Einkommen, Steuerklassen, Gutschriften und Erstattungen kommen nach dem AGI und liegen außerhalb dieser Fähigkeit.

Was passiert, wenn die Abzüge das Bruttoeinkommen übersteigen?

Der Rechner lehnt die Eingabe ab, statt ein negatives AGI auszugeben. Meist wurden versehentlich nachrangige Posten wie der Standardabzug oder Hypothekenzinsen in die Liste aufgenommen.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/fin/agi

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/fin/agi \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"gross_income":85000,"deductions":[{"label":"student loan interest","amount":2500},{"label":"traditional IRA contribution","amount":6500}]}'

const res = await fetch("https://api.kit.forhosting.com/fin/agi", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "gross_income": 85000,
    "deductions": [
      {
        "label": "student loan interest",
        "amount": 2500
      },
      {
        "label": "traditional IRA contribution",
        "amount": 6500
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/agi",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "gross_income": 85000,
    "deductions": [
        {
            "label": "student loan interest",
            "amount": 2500
        },
        {
            "label": "traditional IRA contribution",
            "amount": 6500
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/agi", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"gross_income":85000,"deductions":[{"label":"student loan interest","amount":2500},{"label":"traditional IRA contribution","amount":6500}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"gross_income":85000,"deductions":[{"label":"student loan interest","amount":2500},{"label":"traditional IRA contribution","amount":6500}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/agi", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "gross_income": 85000,
  "deductions": [
    {
      "label": "student loan interest",
      "amount": 2500
    },
    {
      "label": "traditional IRA contribution",
      "amount": 6500
    }
  ]
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.agi",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Technische Hinweise

Sie senden Bruttoeinkommen und Abzüge als strukturierte Daten; die API validiert jeden Wert, summiert die Abzüge, subtrahiert sie und liefert das AGI zusammen mit der Aufschlüsselung.

Wie die Berechnung und ihre Validierung funktionieren

Jede Zahl muss endlich und größer oder gleich null sein — ein negativer Abzug ist keine Gutschrift, sondern ein Datenfehler, und die API sagt das, statt stillschweigend Einkommen hinzuzurechnen. Die Abzugsbeträge werden summiert und mit dem Bruttoeinkommen verglichen: Übersteigt die Summe das Erzielte, wird die Anfrage mit einem typisierten Fehler abgelehnt, denn ein AGI unter null allein aus above-the-line-Abzügen bedeutet, dass die Eingaben vermischt wurden — typischerweise durch below-the-line-Posten wie den Standardabzug oder Hypothekenzinsen.

Wo das AGI in echten Arbeitsabläufen steht

Die API berechnet anschließend $0.002 pro Anfrage für die identische Antwort, ohne Mindestmengen und ohne Datenspeicherung — die Zahlen werden verarbeitet und verworfen, und nur das berechnete Ergebnis geht an den Aufrufer zurück.

Integrationsbeispiele

Zahlen vor der Erklärung validieren

Senden Sie Bruttoeinkommen und Abzüge genau so, wie sie erfasst wurden, und lassen Sie die API negative Beträge oder Abzüge über dem Einkommen erkennen.

Technische Fragen

Was passiert, wenn die Abzüge das Bruttoeinkommen übersteigen?

Die Anfrage wird mit einem invalid_input-Fehler abgelehnt. Das AGI kann allein durch above-the-line-Abzüge nicht unter null fallen; diese Situation bedeutet also, dass die Eingaben vermischt wurden.

Vollständige KIT-Dokumentation lesen →

AGI

Im Browser ausführen – kostenlos

Was das bereinigte Bruttoeinkommen wirklich ist

Wie die Berechnung und ihre Validierung funktionieren

Wo das AGI in echten Arbeitsabläufen steht

Anwendungsfälle

Anspruch auf Steuergutschriften abschätzen

Änderung eines Beitrags vor Steuern simulieren

Häufige Fragen

Verwandte Tools

Für Entwickler — API-Zugang

Endpunkt

Aufruf aus Ihrem Stack

Beispiel-Anfrage

Beispiel-Antwort

Preis

Fehler

Technische Hinweise

Wie die Berechnung und ihre Validierung funktionieren

Wo das AGI in echten Arbeitsabläufen steht

Integrationsbeispiele

Zahlen vor der Erklärung validieren

Technische Fragen

danke