Tax Forms

Retrieve and download tax forms for contractors

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:

Form	When it applies
W-9	U.S. contractors
W-8BEN	Non-U.S. individual contractors
W-8BEN-E	Non-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.

If a contractor already has a signed tax form, you can also submit it directly via the API instead of routing them through the app — see Submit a Tax Form.

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.

---

Submit a Tax Form

Submit a completed W-9, W-8BEN or W-8BEN-E on a contractor’s behalf. Upload the signed PDF first using the file upload flow, then pass the returned fileId along with the raw field data.

Response:

{
  "id": "ca51f42c-0adc-4a77-8dd1-a03dd4fb955f"
}

Field	Description
fileId	ID of the uploaded signed form PDF, from the file upload flow
type	Form type — W9, W8BEN or W8BENE
w9 / w8ben / w8bene	The raw field data for the form, matching type
id	Identifier of the created tax form

You must upload a valid, filled and signed tax form (W-9, W-8BEN or W-8BEN-E) as a PDF. 1099-NEC forms cannot be uploaded; they are generated automatically at year-end.

---

List Tax Forms

Retrieve all tax forms for a user.

Response:

{
  "data": [
    {
      "name": "W8BEN",
      "formId": "30c6c36b5ae0985c1d715bbf25b878a1349cc99a",
      "createdAt": 1690339130,
      "isComplete": true,
      "isDocumentDownloadable": true
    }
  ]
}

Field	Description
name	Form type — W9, W8BEN, W8BENE, or 1099
formId	Unique identifier — use this to download the form
createdAt	Unix timestamp when the form was created
isComplete	Whether the form has been fully filled out and signed
isDocumentDownloadable	Whether a PDF download is available

---

Download a Tax Form

Get a temporary download link for a specific form.

Response:

{
  "fileUrl": "https://cadana.com/file/123",
  "expiresAt": 1690339130
}

Field	Description
fileUrl	Temporary URL to download the form PDF
expiresAt	Unix timestamp when the link expires

Only forms with isDocumentDownloadable: true can be downloaded. Check this field before requesting a download link.