Skip to main content
Version: 1.7.3

Overview

Form 1098 (Mortgage Interest Statement) is an IRS tax Form used to report mortgage interests of $600 or more that are received from an individual during the year in the course of the trade or business.

Services you can avail of through TaxBandits API:

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

Form 1098 endpoints:​​

You can use the following endpoints to complete the 1098 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 1098 for the recipients under the corresponding payer. While creating the form, you can opt for postal mail, and online access if required.
  • Update - To make changes to an existing Form 1098.
  • Transmit - To transmit the 1098 to the IRS.
  • Status - To check the status of the 1098 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.

Webhook Configuration for Form 1098 Status Updates​

TaxBandits API enables you to receive automated status updates regarding your Form 1098 forms via webhook. You can configure webhooks for the following event types to receive Form 1098 status updates.

  • E-file Status Change - You will be notified when the IRS accepts or rejects your Form 1098. Learn More
  • Online Access Status Change - You will be notified when the Form 1098 forms are shared with recipients via online access, when recipients provide consent, and when they access the forms. Learn More

Other 1098 Endpoints:​

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

  • ValidateForm - To validate the field-level specifications of Form 1098 before creating the form. (Optional)
  • Validate - To audit the created Form 1098 data before transmission to the IRS.
  • List - To list all Form 1098 created and transmitted on the account for a particular submission or Payer.
  • Get - To retrieve the recipient data, business data, and form data from the 1098 created.
  • GetbyRecordIds - To retrieve the recipient data, business data, and form data using the recordids (without submissionid).
  • Delete - To delete the 1098 return you prepared in TaxBandits.

1098 PDF Retrieval​

You can obtain the PDF version of your 1098 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 1098 PDF. To use this, you must have configured Webhook so that the endpoint will return the PDFs via Webhook.

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

To learn how to retrieve a 1098 PDF, click here