Version: 1.7.3

Update

Use this endpoint to update the information on existing A-1 forms that are already created for a specific employer (payer).

Note:

You cannot update a return once it has been transmitted.

PUTStateFilings/ALA1WH/Update

Run in Postman

Request Body

Field	Type	Description
SubmissionId	String	Unique identifier for the submission.
StateWHRecords	Object[]	Object to create A-1
SequenceId	String	A unique number given by an inbound application to identify failed records. Size Range: ..50
ReturnHeader	Object	Identifies the supporting details of Form A-1.
Qtr	String	The Quarter for which Form A-1 needs to be filed. Allowed values "Q1", "Q2", "Q3", "Q4"
TaxYr	String	The tax year for which Form A-1 needs to be filed. Allowed values 2025
Business	Object	Object to identify the business details.
BusinessId	Guid	Optional Use the unique identifier provided in the response from the Business CREATE endpoint.
BusinessNm	string	Name of the business. Size Range: ..75
TradeNm	string	Optional Name under which the business operates. Size Range: ..75
IsEIN	Boolean	When true, identifies the business with an EIN.
EINorSSN	string	When IsEIN is true, use the Employer Identification Number (EIN) Note: IsEIN should always be set to true, as EIN is the only allowed TIN type for state payroll forms. Size Range: 9-11
Email	string	Optional Email address of the business. Size Range: ..100
ContactNm	string	Optional Name of the person who can be contacted by the State Agency. Size Range: ..27
Phone	string	Optional Phone number of the business. Size Range: 10
PhoneExtn	string	Optional Extension of the business phone number. Size Range: ..5
Fax	string	Optional Fax number of the business. Size Range: 10
BusinessType	string	Type of business. Size Range: 4 Allowed values "ESTE", "PART", "CORP", "EORG", "SPRO"
SigningAuthority	object	Details of the person who is authorized to sign the return.
Name	string	Name of the signing authority. Size Range: ..35
Phone	string	Phone number of the signing authority. Size Range: 10
BusinessMemberType	string	Business title of the signing authority Size Range: 5..29 Allowed values "CORPORATESECRETARY", "SECRETARYTREASURER", "PARTNER", "GENERALPARTNER", "LIMITEDPARTNER", "LLCMEMBER", "MANAGINGMEMBER", "MANAGER", "TAXMATTERPARTNER", "PRESIDENT", "VICEPRESIDENT", "CORPORATETREASURER", "TREASURER", "ASSISTANTTREASURER", "CHIEFACCOUNTINGOFFICER", "CHIEFEXECUTIVEOFFICER", "CHIEFFINANCIALOFFICER", "TAXOFFICER", "CHIEFOPERATINGOFFICER", "CORPORATEOFFICER", "EXECUTIVEDIRECTOR", "DIRECTOR", "CHAIRMAN", "EXECUTIVEADMINISTRATOR", "RECEIVER", "PASTOR", "ASSISTANTTORELIGIOUSLEADER", "REVEREND", "PRIEST", "MINISTER", "RABBI", "LEADEROFRELIGIOUSORGANIZATION", "SECRETARY", "DIRECTOROFTAXATION", "DIRECTOROFPERSONNEL", "ADMINISTRATOR", "EXECUTOR", "TRUSTEE", "FIDUCIARY", "OWNER", "SOLEPROPRIETOR", "MEMBER", "SOLEMEMBER"
KindOfEmployer	string	Optional Identifies the kind of employer. Allowed values "FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY"
KindOfPayer	string	Optional Identifies the kind of payer. Allowed values "REGULAR941", "REGULAR944", "AGRICULTURAL943", "HOUSEHOLD", "MILITARY", "MEDICAREQUALGOVEM", "RAILROADFORMCT1"
IsBusinessTerminated	Boolean	When true, indicates that the business is terminated.
IsForeign	Object	When true, indicates that the business has a foreign address.
USAddress	object	If IsForeign is false, pass the US address of the business.
Address1	string	Employer/Payer's US address (street or post office box of that locality). Size Range: ..46
Address2	string	Optional Employer/Payer's suite or apartment. Size Range: ..46
City	string	Employer/Payer's city. Size Range: ..50
State	string	Employer/Payer's state code. Refer to static values. Size Range: 2 Allowed values "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP"
ZipCd	string	Employer/Payer's zip code. Size Range: 5..10
ForeignAddress	Object	If IsForeign is true, pass the foreign address of the business.
Address1	string	Employer/Payer's foreign address (street address or post office box of that locality). Size Range: ..50
Address2	string	Optional Employer/Payer's suite or apartment. Size Range: ..50
City	string	Employer/Payer's city. Size Range: ..50
ProvinceOrStateNm	string	Employer/Payer's province or state name. Size Range: ..50
Country	string	Employer/Payer's country. Size Range: 2 Allowed values "AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI","CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA","MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"
PostalCd	string	Employer/Payer's postal code. Size Range: ..16
ReturnData	Object[]	Identifies the Form A-1 data.
FormA1	Object	Alabama withholding quarterly tax return.
WHIdNum	String	Alabama withholding account number. Allowed values "0000123456" or "R007000000"
IsCloseWHAcc	Boolean	When true, specifies that the account is to be cancelled.
LastPaymentDate	String	Enter tha last payment date Allowed values MM/DD/YYYY or MM-DD-YYYY
IsChangeOfAddr	Boolean	When true, specifies there is a change in address
L2NumOfEmployees	Number	The total number of employees for the quarter. Size Range: 0-99999
L3WHAmt	Number	Total Alabama income tax withheld for the quarter Size Range: 0-9999999999.99
L4TaxPaid	Number	Tax remitted for first 2 months Size Range: 0-9999999999.99
IsOverpayment	Boolean	When true, indicates an overpayment credit from a prior period.
PYOverpaymentCrdt	Object	Identifies details of any overpayment from an previous tax years
CrdtPeriod	String	Identifies the prior credit period of prior overpayment Allowed values MM/YYYY
WHAmt	Number	Prior Withheld amount Size Range: 0-9999999999.99
TaxPaid	Number	Prior Tax Paid Size Range: 0-9999999999.99
OverpaymentCrdtAmt	Number	Prior Overpayment credit amount Size Range: 0-9999999999.99
QtrOverpaymentCrdt	Object[]	Identifies details of any overpayment from an earlier quarter of the current tax year
Qtr	String	Identifies the prior quarter of prior overpayment Allowed values MM/YYYY
CrdtPeriod	String	Identifies the prior credit period of prior overpayment Allowed values MM/YYYY
WHAmt	Number	Prior Withheld amount Size Range: 0-9999999999.99
TaxPaid	Number	Prior Tax Paid Size Range: 0-9999999999.99
OverpaymentCrdtAmt	Number	Prior Overpayment credit amount Size Range: 0-9999999999.99
L6Penalty	Number	Penalties for the quarter Size Range: 0-99999999.99
L7Interest	Number	Total interest amount for the quarter Size Range: 0-99999999.99
L8BalanceDue	Number	Total amount due for the quarter Size Range: 0-99999999.99
L9AmtPaid	Number	Remitted amount with the return Size Range: 0-99999999.99
IsExemptOvertimePaymentWages	Boolean	When true, identifies exempt overtime payment wages is reported
ExemptOvertimePaymentDetails	Object	Identifies exempt overtime payment details
NumOfEmp	Number	Number of Employees with Exempt Overtime Wages Size Range: 0-99999999
TotOvertimeWagePaid	Object	Total Amount of Exempt Overtime Wages Paid Size Range: 0-9999999999.99
PaymentType	String	Payment type for the remitted amount Allowed values "EFT_Credit", "EFT_Debit"
StatePayment	Object	Object to identify the state payment details
RoutingTransitNumber	String	Bank routing number for state payment Size Range: 9
BankAccountNumber	String	Bank account number for state payment Size Range: ..17
PaymentAmt	Number	Payment amount for state payment Size Range: 0-99999999.99
AccountType	string	Type of the bank account Allowed values "Checking", "Saving"
ReqPaymentDate	String	Date the payment is to be scheduled. Allowed values MM/DD/YYYY, MM-DD-YYYY

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier of a submission
SuccessRecords	object[]	It will show the detailed information about the success status of Form A-1 Records
SequenceId	string	A unique number given by an inbound application to identify particular records.
BusinessId	Guid	Unique identifier of a Business
PayerRef	string	Unique identifier of the payer
RecordId	Guid	An unique identifier generated by TaxBandits when a A-1 return is created
FormType	string	Denotes the type of withholding form (Form A-1).
Status	string	Returns the record status of return.
StatusTs	string	Date and time of the return created.
Info	string	Returns the information about the return
Errors	object[]	Shows error information of state returns of Form A-1
Id	string	Returns the validation error Id.
Name	string	Name of the validation error.
Message	string	Description of the validation error.
ErrorRecords	object[]	It will show the detailed information about the error status of Form A-1 Records.
SequenceId	string	A unique number given by an inbound application to identify particular records. The Sequence ID will be returned in the Response for your reference.
RecordId	Guid	Unique identifier of a record
Errors	object[]	Shows detailed error information
Id	string	Returns the validation error Id
Name	string	Name of the validation error
Message	string	Description of the validation error
Errors	object[]	Shows detailed error information.
Id	string	Returns the validation error Id.
Name	string	Name of the validation error.
Message	string	Description of the validation error.

Request JSON

{
     "SubmissionId": "019c9d54-05cc-7249-82d1-580e441f9ace",
    "StateWHRecords": [
        {
            "Sequence": "001",
            "RecordId": "019c9d54-3412-737c-8a75-e75d39597914",
            "ReturnHeader": {
                "Qtr": "Q2",
                "TaxYr": "2025",
                "Business": {
                    "BusinessId": "30d0205f-9b49-455d-bffe-fe961f81b2a6",
                    "BusinessNm": "John LLC",
                    "PayerRef": "",
                    "FirstNm": null,
                    "MiddleNm": null,
                    "LastNm": null,
                    "Suffix": null,
                    "TradeNm": "",
                    "IsEIN": true,
                    "EINorSSN": "01-8888361",
                    "Email": "john@gmail.com",
                    "ContactNm": null,
                    "Phone": "(787) 987-9879",
                    "PhoneExtn": "",
                    "Fax": "7897897987",
                    "BusinessType": "ESTE",
                    "SigningAuthority": {
                        "Name": "John",
                        "Phone": "7897897987",
                        "BusinessMemberType": "ADMINISTRATOR"
                    },
                    "KindOfEmployer": "NONGOVT501C",
                    "KindOfPayer": "REGULAR941",
                    "IsBusinessTerminated": false,
                    "IsForeign": false,
                    "USAddress": {
                        "Address1": "12 Main St",
                        "Address2": null,
                        "City": "Rock Hill",
                        "State": "SC",
                        "ZipCd": "29730"
                    },
                    "ForeignAddress": null,
                    "ACADetails": null
                }
            },
            "ReturnData": {
                "FormA1": {
                    "WHIdNum": "R007000000",
                    "LastPaymentDate": "12/21/2025",
                    "IsChangeOfAddr": false,
                    "L2NumOfEmployees": 52,
                    "L3WHAmt": 1000,
                    "L4TaxPaid": 2000,
                    "PYOverpaymentCrdt": {
                        "CrdtPeriod": "2024",
                        "WHAmt": 1000,
                        "TaxPaid": 2000,
                        "OverpaymentCrdtAmt": 1000
                    },
                    "QtrOverpaymentCrdt": [
                        {
                            "Qtr": "Q4",
                            "WHAmt": "1000.00",
                            "TaxPaid": "2000.00",
                            "CrdtPeriod": "11/2025",
                            "OverpaymentCrdtAmt": "1000.00"
                        }
                    ],
                    "L6Penalty": 0,
                    "L7Interest": 0,
                    "L8BalanceDue": -2000,
                    "L9AmtPaid": -2000,
                    "TotOverpaymentAmt": 2000,
                    "TotBalanceDueAmt": 0,
                    "IsExemptOvertimeWage": true,
                    "ExemptOvertimePaymentDetails": {
                        "NumOfEmployees": 13,
                        "TotOvertimeWagePaid": 1000
                    }
                },
                "StatePayment": {
                    "PaymentAmt": 100,
                    "RoutingTransitNumber": "217555555",
                    "BankAccountNumber": "0000000001",
                    "AccountType": "Checking",
                    "ReqPaymentDate": "12/31/2025"
                }
            }
        }
    ]
}

Response JSON

{
    "StatusCode": "200",
    "StatusName": "Ok",
    "StatusMessage": "Successful API call",
    "SubmissionId": "019c9d54-05cc-7249-82d1-580e441f9ace",
    "SuccessRecords": [
        {
            "SequenceId": "001",
            "BusinessId": "30d0205f-9b49-455d-bffe-fe961f81b2a6",
            "PayerRef": null,
            "RecordId": "019c9d54-3412-737c-8a75-e75d39597914",
            "FormType": "A1",
            "Status": "CREATED",
            "StatusTs": "2026-02-27 10:28:14 +05:30",
            "Info": null,
            "Errors": null
        }
    ],
    "ErrorRecords": null,
    "Errors": null
}

W-9/W-8 Automation

1099 Automation

TIN Matching

W-2 Automation

941/940 Automation

1098-T Automation

ACA Automation

Extension Automation

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Supported Forms

Update

Update

Request Body

Response Body

Request JSON​

Response JSON​

Request JSON

Response JSON