API referencellms.txt
Taxpayers
The person you save and pay taxes for. Checks start the moment one is created.
Create a taxpayer
POST
/v1/taxpayersCreates the taxpayer and starts verification.
Fields
namestringRequired- Legal name.
emailstringRequired- Where we send receipts if you ask us to.
statestringRequired- Two-letter state of residence, like
NY. ssnstringRequired- Full Social Security number. Write-only: never returned.
date_of_birthstringRequiredYYYY-MM-DD.filing_statusstringsingle,married_joint,married_separateorhead_of_household. Defaults tosingle.businessobjectnameandein, if they have a business.bank_accountobjectrouting_numberandaccount_numberthey save from.external_idstring- Your own ID for this person.
curl -X POST "https://api.workmade.com/v1/taxpayers" \ -H "Authorization: Bearer $WORKMADE_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Maya Ortiz", "email": "maya@ortiz.studio", "state": "NY", "ssn": "123-45-6789", "date_of_birth": "1991-04-22" }'
{
"id": "tp_8Kq2",
"object": "taxpayer",
"name": "Maya Ortiz",
"email": "maya@ortiz.studio",
"state": "NY",
"filing_status": "single",
"business": {
"name": "Ortiz Studio LLC",
"ein_last4": "0921"
},
"status": "ready",
"ready_to_pay": true,
"external_id": "usr_4471",
"created": "2026-03-02T15:04:11Z"
}Retrieve a taxpayer
GET
/v1/taxpayers/tp_8Kq2Returns one taxpayer.
curl "https://api.workmade.com/v1/taxpayers/tp_8Kq2" \ -H "Authorization: Bearer $WORKMADE_KEY"
{
"id": "tp_8Kq2",
"object": "taxpayer",
"name": "Maya Ortiz",
"email": "maya@ortiz.studio",
"state": "NY",
"filing_status": "single",
"business": {
"name": "Ortiz Studio LLC",
"ein_last4": "0921"
},
"status": "ready",
"ready_to_pay": true,
"external_id": "usr_4471",
"created": "2026-03-02T15:04:11Z"
}List taxpayers
GET
/v1/taxpayersNewest first. Filter by status: ready, verifying or short.
curl "https://api.workmade.com/v1/taxpayers?status=ready&limit=20" \ -H "Authorization: Bearer $WORKMADE_KEY"
{
"object": "list",
"data": [
{
"id": "tp_8Kq2",
"object": "taxpayer",
"name": "Maya Ortiz",
"email": "maya@ortiz.studio",
"state": "NY",
"filing_status": "single",
"business": {
"name": "Ortiz Studio LLC",
"ein_last4": "0921"
},
"status": "ready",
"ready_to_pay": true,
"external_id": "usr_4471",
"created": "2026-03-02T15:04:11Z"
}
],
"has_more": true
}POSTCreate a taxpayer
curl -X POST "https://api.workmade.com/v1/taxpayers" \ -H "Authorization: Bearer $WORKMADE_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Maya Ortiz", "email": "maya@ortiz.studio", "state": "NY", "ssn": "123-45-6789", "date_of_birth": "1991-04-22" }'
{
"id": "tp_8Kq2",
"object": "taxpayer",
"name": "Maya Ortiz",
"email": "maya@ortiz.studio",
"state": "NY",
"filing_status": "single",
"business": {
"name": "Ortiz Studio LLC",
"ein_last4": "0921"
},
"status": "ready",
"ready_to_pay": true,
"external_id": "usr_4471",
"created": "2026-03-02T15:04:11Z"
}Was this page helpful?