Skip to main content
Contractors hired by U.S. businesses are required to complete and sign a tax form as part of their wallet onboarding. The applicable form depends on the contractor’s tax residency:
FormWhen it applies
W-9U.S. contractors
W-8BENNon-U.S. individual contractors
W-8BEN-ENon-U.S. entity contractors
Contractors complete and sign their tax form through the Cadana app during wallet onboarding. Once signed, you can retrieve and download the completed forms via the API.
1099-NEC forms are generated automatically at tax year-end for U.S. contractors with a completed W-9 who earned at least $600. They appear alongside other forms in the list endpoint once filed.

​
List Tax Forms

Retrieve all tax forms for a user.
bash
curl -X GET 'https://api.cadanapay.com/v1/users/{userId}/tax-forms' \
  -H 'Authorization: Bearer YOUR_API_KEY'
Response: 
{
  "data": [
    {
      "name": "W8BEN",
      "formId": "30c6c36b5ae0985c1d715bbf25b878a1349cc99a",
      "createdAt": 1690339130,
      "isComplete": true,
      "isDocumentDownloadable": true
    }
  ]
}
FieldDescription
nameForm type — W9, W8BEN, W8BENE, or 1099
formIdUnique identifier — use this to download the form
createdAtUnix timestamp when the form was created
isCompleteWhether the form has been fully filled out and signed
isDocumentDownloadableWhether a PDF download is available

​
Download a Tax Form

Get a temporary download link for a specific form.
bash
curl -X GET 'https://api.cadanapay.com/v1/users/{userId}/tax-forms/{formId}/download' \
  -H 'Authorization: Bearer YOUR_API_KEY'
Response: 
{
  "fileUrl": "https://cadana.com/file/123",
  "expiresAt": 1690339130
}
FieldDescription
fileUrlTemporary URL to download the form PDF
expiresAtUnix timestamp when the link expires
Only forms with isDocumentDownloadable: true can be downloaded. Check this field before requesting a download link.