Tax Forms

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.

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

Get Started

Workforce Management

Payroll & Compliance

White-Label UI

Platform Integration

Payments

Wallets

List Tax Forms

Download a Tax Form

​List Tax Forms

​Download a Tax Form

List Tax Forms

Download a Tax Form