Skip to main content
Version: 1.7.1

Overview

Form 1099-SA is an IRS information return used to report distributions made from a Health savings account (HSA), Archer Medical Savings Account (Archer MSA), and Medicare Advantage Medical Savings Account (MA MSA) to any individual taxpayers.

Services you can avail of through TaxBandits API:​

  • Federal Filing - E-file 1099-SA with the IRS.
  • Postal Mailing - Distribute the recipient copy of Form 1099-SA via Postal Mail.
  • Online Access - Make the digital copies of Form 1099-SA available online for the corresponding recipients.

Form 1099-SA endpoints:​

You can use the following endpoints to complete the 1099-SA filing.

note

In order to use the following endpoints, you must call the Auth method to get the access token. This access token must be supplied in the request header as the ‘Bearer‘ token. Refer to OAuth 2.0 Authentication for more information on JWT authentication.

  • Create - To create Form 1099-SA for the recipients under the corresponding payer. While creating the form, you can opt for state filing, postal mail, and online access if required.
  • Update - To make changes to an existing Form 1099-SA.
  • Transmit - To transmit the 1099-SA to the IRS.
  • Status - To check the status of the 1099-SA after transmission. (As an alternative, you can configure Webhooks for E-file Status Change)

If you need to retrieve Form PDFs, you can use one of the endpoints mentioned here.

Other 1099-SA Endpoints:​

You can use any of the following endpoints based on your needs.

  • ValidateForm - To validate the field-level specifications of form 1099-SA before creating the form. (Optional)
  • Validate - To audit the created Form 1099-SA data before transmission to the IRS.
  • List - To list all Form 1099-SA for a submission or Payer.
  • Get - To retrieve the recipient data, business data and form data from the 1099-SA created.
  • GetbyRecordIds - To retrieve the recipient data, business data, and form data using the recordids (without submissionid).
  • Delete - To delete the 1099-SA return you prepared in TaxBandits.
  • GenerateFromTxns - Use this method if you want to generate 1099-SA for the given business and recipient IDs based on the transactions you recorded using Form1099Transactions.
  • Approve - To approve the transactions that are created using TaxBandits

1099-SA PDF Retrieval​

You can obtain the PDF version of your 1099-SA forms using one of the following endpoints:

  • RequestDraftPdfUrl - To return the Draft PDF for review purposes. These forms are not transmitted and will have a watermark "For Review only" on it.
  • RequestPdfURLs - To retrieve PDFs for single or multiple recipients.
  • GetPDF - To get the link for Form 1099-SA PDF. To use this, you must have configured Webhook for it so that the endpoint will return the PDFs via Webhook.

Note: To retrieve the final version of 1099 Form PDFs, you can use either RequestPdfURL or GetPDF and not both.

To learn how to retrieve a 1099 PDF, click here