Overview

Alabama employers who withhold state income tax from employee wages must file returns with the Alabama Department of Revenue (ADOR). Returns are required every filing period, even if no tax was withheld.

The TaxBandits API supports the automation of Form A-1 and Form A-6, Alabama's two state withholding filings.

Forms supported

Form	Type	Filing frequency	Due date
Form A‑1	WH	Quarterly	Last day of the month following the quarter end: April 30, July 31, October 31, January 31
Form A‑6	WH	Monthly (required when withholding exceeds $1,000 for the month)	15th of the following month

Key compliance notes

• Zero filing required. Form A-1 must be filed every quarter, even if no tax was withheld or no wages were paid during that period.
• Account registration. Employers must register for a withholding tax account with ADOR before filing returns.
• Requires an EIN. For state payroll filings, IsEIN must always be set to TRUE. EIN is the only accepted TIN type at the state level; SSNs are not supported.
• Monthly vs. quarterly. Use Form A-6 for monthly remittance once withholding crosses the $1,000 threshold, and Form A-1 for the standard quarterly reconciliation.
• Payment methods. Alabama accepts both EFT_Credit and EFT_Debit payment types for remitted amounts.
• Overpayment carryforward. Both forms support reporting prior-year and prior-quarter overpayment credits, which reduce the current balance due.

Available endpoints

Based on the form you're required to file, use the corresponding endpoints.

To use the following endpoints, you must first call the Auth method to obtain an access token. Include this token in your request header as a Bearer token. Refer to OAuth 2.0 Authentication for details on JWT-based authentication.

Form A-1

• Create – Generates a new Form A-1 quarterly withholding return for the specified tax year and quarter.
• Update – Modifies the details of a previously created Form A-1 return before it's transmitted.
• Get – Retrieves the details of a previously created Form A-1 return.

Form A-6

• Create – Generates a new Form A-6 monthly withholding return for the specified reporting month.
• Update – Modifies the details of a previously created Form A-6 return before it's transmitted.
• Get – Retrieves the details of a previously created Form A-6 return.

Before filing, you can simulate the entire verification flow in our Sandbox environment without submitting real data to state agencies. See how

Common endpoints

Unlike the state-specific endpoints, the payload for these common endpoints is the same for all states, making them applicable for both withholding and UI forms.

• List – Retrieve a list of forms (withholding or UI) that have been created for a specific business or period.
• Delete – Delete an in-progress form before it is transmitted to the state.
• Transmit – Submit your form to the corresponding state.
• RequestPdfUrls – Get a link to download the PDF version of the form (draft or final).
• Status – Check the status of a submitted form to know whether it was accepted or rejected by the state.

As an alternative to this endpoint, you can configure webhooks for the event type Status Payroll Filings Status Change to receive automated status updates.