Job Refund Amounts
Resource representing the refund amounts on a job in your workspace.
The Job refund amounts, containing one entry per tax year for which refund amounts have been recorded and ordered by tax year ascending. Amounts are recorded automatically when they are extracted from the tax return during document verification, and by the Pro when they file the return.
Job Refund Amounts Properties
The job's ID.
An array of amounts, containing one entry per tax year.
jsonCopied1{2 "job_id": "a439ddfa-6ba4-4b38-8cf0-5d09db1a0af4",3 "amounts": [4 {5 "tax_year": "2024",6 "federal_amount": -812.00,7 "amount_by_state": [],8 "source": "EXTRACTED"9 },10 {11 "tax_year": "2025",12 "federal_amount": 2450.00,13 "amount_by_state": [14 {15 "state": "CA",16 "amount": 375.5017 }18 ],19 "source": "MANUAL"20 }21 ]22}
Amounts
The signed federal amount. A decimal number, or null if no federal amount was recorded. A positive number is a
refund, and a negative number is an amount owed.
An array of signed state amounts. For:
state- The state abbreviation (e.g.,"CA","NY").amount- The signed amount for that state as a decimal number.
Refund Amounts by Year Properties
The tax year the amounts belong to, as a string (e.g., "2025").
The signed federal amount for the tax year. A decimal number, or null if no federal amount was recorded. A
positive number is a refund, and a negative number is an amount owed.
An array of signed state amounts for the tax year, empty when no state amounts were recorded. Each:
state- The state abbreviation (e.g.,"CA","NY").amount- The signed amount for that state as a decimal number.
Where the tax year's amounts came from. One of:
EXTRACTED- Extracted automatically from the tax return during document verification.MANUAL- Entered by the Pro when they filed the return. Amounts entered by the Pro take precedence over extracted amounts for the same tax year.