Skip to content

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.

Endpoints

MethodUrl
GET/v1.0/jobs/{job_id}/refund-amounts

Job Refund Amounts Properties

job_id

The job's ID.

amounts

An array of amounts, containing one entry per tax year.

json
Copied
1{
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.50
17 }
18 ],
19 "source": "MANUAL"
20 }
21 ]
22}

Amounts

federal_amount

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.

amount_by_state
•
array

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

tax_year

The tax year the amounts belong to, as a string (e.g., "2025").

federal_amount

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.

amount_by_state
•
array

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.
source

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.
Last updated on November 16, 2026