DP.

Documentation

API URL

GET /api/v1/income-tax

Headers
Code
Content-Type: application/json
Query Parameters

Example GET Request

Code
GET https://datpaq.com/api/v1/income-tax?api_key=your-api-key&filingStatus=single&taxYear=2024&income=120000&deductions=5000&taxCredits=2000&stateRate=5.5

Successful Response

Status
HTML
200 OK
Body
Code
{
  "success": true,
  "source": "snapshot",
  "taxYear": 2024,
  "filingStatus": "single",
  "grossIncome": 120000,
  "standardDeduction": 14600,
  "additionalDeductions": 5000,
  "taxCredits": 2000,
  "totalDeductions": 19600,
  "taxableIncome": 100400,
  "totalFederalTax": 17141,
  "totalFederalTaxAfterCredits": 15141,
  "stateRate": 5.5,
  "estimatedStateTax": 5522,
  "totalEstimatedTax": 20663,
  "effectiveRate": 14.28,
  "effectiveRateAfterCredits": 12.62,
  "totalEffectiveRate": 17.22,
  "marginalRate": 0.22,
  "estimatedMonthlyTax": 1262,
  "estimatedMonthlyTotalTax": 1722,
  "breakdown": [
    {
      "rate": 0.1,
      "bracketStart": 0,
      "bracketEnd": 11600,
      "taxedAmount": 11600,
      "taxAmount": 1160
    },
    {
      "rate": 0.12,
      "bracketStart": 11600,
      "bracketEnd": 47150,
      "taxedAmount": 35550,
      "taxAmount": 4266
    },
    {
      "rate": 0.22,
      "bracketStart": 47150,
      "bracketEnd": 100525,
      "taxedAmount": 53250,
      "taxAmount": 11715
    }
  ],
  "metadata": {
    "correlationId": "request-id",
    "api_token_name": null,
    "processingTime": "5ms",
    "timestamp": "2026-10-14T12:00:00.000Z",
    "rate_limit": null
  }
}

Error Response

Example
Code
HTTP 400 ValidationError: Invalid query or unsupported filing status tax year or numeric range — Request rejected by schema or service validation; HTTP 401 Unauthorized: Missing or invalid API key — Gateway authentication rejects the request; HTTP 404 NotFound: Unknown route or requested year has no available tax tables — Request cannot be resolved; HTTP 429 RateLimited: Request volume exceeds 200 per 15-minute window per IP — Rate limiter rejects the request; HTTP 500 InternalError: Metrics generation failure — Metrics route returns an empty HTTP 500 response; HTTP 502 ProcessingError: Unexpected tax-table or calculation failure — Route returns a processing error with response metadata; HTTP 503 DataUnavailable: Database query failed and snapshot fallback is unavailable — Service reports temporary tax-table unavailability

Last Updated:  May 4, 2026