Get credits by ZIP
get_creditsRead-only
Retrieve Earned Income Tax Credit and additional child tax credit counts and amounts for a U.S. ZIP code from IRS SOI data. See refundable-credit take-up for any area.
Instructions
Refundable-credit take-up for a ZIP: the EITC and additional child tax credit.
`zip_code`: a 5-digit US ZIP. Returns the number of returns and total amount
for the Earned Income Tax Credit (overall and split by number of qualifying
children: none / one / two / three or more), plus the additional (refundable)
child tax credit. Amounts in USD.
Note: a 0 may be IRS-suppressed (<20 returns in each AGI-bracket cell)
rather than a true zero — it does not prove no one claims the credit.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip_code | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | 2-letter USPS state code | |
| zipcode | Yes | 5-digit ZIP code | |
| tax_year | Yes | SOI tax year of the data | |
| eitc_amount | No | Total EITC amount (USD) | |
| eitc_returns | No | Number of returns claiming the EITC | |
| eitc_by_children | Yes | EITC returns and amount split by number of qualifying children | |
| additional_ctc_amount | No | Additional (refundable) child tax credit amount (USD) | |
| additional_ctc_returns | No | Number of returns with the additional (refundable) child tax credit |