Skip to main content
POST
/
api
/
v1
/
income-docs
Create Income Document
curl --request POST \
  --url https://api.example.com/api/v1/income-docs \
  --header 'Content-Type: application/json' \
  --data '
{
  "doc_type": "<string>",
  "tax_year": 123,
  "agency": "<string>",
  "wages_cents": 123,
  "federal_withheld_cents": 123,
  "state_withheld_cents": 123,
  "s3_key": "<string>",
  "notes": "<string>"
}
'

​
Request Body

​
doc_type
string
required
Document type: w2, 1099_nec, or 1099_misc.
​
tax_year
integer
required
Tax year on the document (YYYY).
​
agency
string
Agency name (max 255 chars). Autocompletes from existing assignments.
​
wages_cents
integer
Total wages reported in cents. Must be ≥ 0.
​
federal_withheld_cents
integer
Federal income tax withheld in cents. Must be ≥ 0.
​
state_withheld_cents
integer
State income tax withheld in cents. Must be ≥ 0.
​
s3_key
string
S3 key of the uploaded document.
​
notes
string
Additional notes (max 1000 chars).

​
Response

Returns the created document with status 201.