Skip to main content
Migrating from v1.7.3 to v2.0 View the migration guide for a full breakdown of what's changed and how to update your integration. View Migration Guide
Version: 2.0

Overview

Form 1099-SA is the IRS information return used to report distributions made from a Health Savings Account (HSA), Archer Medical Savings Account (Archer MSA), or Medicare Advantage Medical Savings Account (MA MSA).

This form is generally filed by trustees, custodians, or account administrators when distributions are made to an account holder or paid directly to a medical service provider on behalf of the account holder. A copy must be filed with the IRS and furnished to the corresponding recipient.

A separate Form 1099-SA must be filed for each account type.

1099-SA automation with TaxBandits API​

The TaxBandits API enables you to automate Form 1099-SA filing directly from your existing systems.

If you already have recipient data and annual payment totals in your system, use the API endpoints to create and transmit 1099-SA forms directly.

Best for: HSA administrators, financial institutions, benefits platforms, custodians, and account management systems that already maintain recipient and distribution records and need a reliable way to file Form 1099-SA.

Learn more about workflows

Supported tax years​

TaxBandits API supports e-filing of Form 1099-SA for the following tax years:

Tax YearAPI Version
2026v2
2025v2, v1.7.3
2024v1.7.3

Services available​

The TaxBandits API supports the following services for Form 1099-SA:

  • Federal Filing — File 1099-SA returns with the IRS.
  • Postal Mailing — TaxBandits prints and mails the recipient copy on your behalf.
  • Online Access — Share a digital copy of the 1099-SA with recipients through a secure, branded online portal. Recipients are notified via email and can view, download, and consent to paperless delivery.
  • Corrections — File corrections for 1099-SA forms that are already accepted by the IRS (even if original returns filed elsewhere).

1099-SA endpoints​

All endpoints require a Bearer token obtained through the OAuth 2.0 authentication flow. Include this token in the Authorization header of every request. Learn more about OAuth 2.0.

  • Create — Create one or more 1099-SA records in a single submission. Federal e-file and recipient distribution can all be requested in the same call.
  • Update — Modify an existing 1099-SA submission before it has been transmitted to the IRS.
  • ValidateForm — Validate 1099-SA field-level specifications against the IRS business rules before creating the form.
  • Get — Retrieve payer, recipient, and form data for a specific 1099-SA submission by SubmissionId.

1099 utility endpoints​

The following endpoints are shared across all 1099 form types.

  • List — List all 1099-SA records for a submission or payer.
  • Status — Use this endpoint to retrieve the status of the 1099-SA submitted to the IRS and/or states..
  • Transmit — Transmit the created return to the IRS and state agencies.
  • StatusLog — Retrieved the status change of the transmitted return.
  • RequestDraftPdfUrl — Returns a draft PDF URL for review. These forms are not for filing and will have a watermark "For Review only" on them.
  • RequestPdfURLs — Retrieve final PDF URLs for one or more recipients after transmission.
  • Delete — Delete the returns created before transmitting.

As an alternative to the Status endpoint, you can configure webhooks to receive automated status updates. Learn more.