Get
Get
Use this endpoint to retrieve the information of a previously created A-6 form for the corresponding employer (payer). Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the forms.
GET StateFilings/ALA6WH/Get?SubmissionId=019c9d54-05cc-7249-82d1-580e441f9aceRequest Params
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier created by TaxBandits for each submission. Not required when you are creating a return. |
| RecordId | Guid | An unique identifier generated by TaxBandits when a A-6 return is created. Mention the return's Record ID that you want to get. |
Response Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | String | Unique identifier for the submission. |
| StateWHRecords | Object[] | Object to create A-6 |
| 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-6. |
| Qtr | String | The Quarter for which Form A-6 needs to be filed.Allowed values"Q1", "Q2", "Q3", "Q4" |
| TaxYr | String | The tax year for which Form A-6 needs to be filed.Allowed values2025 |
| 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 |
| 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-6 data. |
| FormA6 | 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 dateAllowed valuesMM/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 overpaymentAllowed valuesMM/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 over paymentAllowed valuesMM/YYYY |
| CrdtPeriod | String | Identifies the prior credit period of prior over paymentAllowed valuesMM/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 amountAllowed 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 accountAllowed values"Checking", "Saving" |
| ReqPaymentDate | String | Date the payment is to be scheduled.Allowed valuesMM/DD/YYYY, MM-DD-YYYY |
Request Params
"statefilings/ala6wh/Get?RecordId=019c9d54-3412-737c-8a75-e75d39597914&SubmissionId=019c9d54-05cc-7249-82d1-580e441f9ace"
Response JSON
- 200
- 400
- 401
Success Response - This is a sample response for successful API requests.
{
"StatusCode": "200",
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "019c9d99-5a69-769a-a2fd-8e5ce4148db0",
"StateWHRecords": [
{
"Sequence": "001",
"RecordId": "019c9d99-8d7f-77aa-8598-9fc8227315f2",
"ReturnHeader": {
"Qtr": "Q1",
"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": {
"FormA6": {
"Month": "APR",
"WHIdNum": "R007000000",
"LastPaymentDate": "12/21/2025",
"IsChangeOfAddr": false,
"L2NumOfEmployees": 2,
"L3WHAmt": 1000,
"IsOverpayment": false,
"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": 200,
"L7Interest": 0,
"L8BalanceDue": 200,
"L9AmtPaid": 200,
"TotOverpaymentAmt": 0,
"TotBalanceDueAmt": 200,
"IsExemptOvertimeWage": true,
"ExemptOvertimePaymentDetails": {
"NumOfEmployees": 13,
"TotOvertimeWagePaid": 1000
}
},
"StatePayment": {
"PaymentAmt": 100,
"RoutingTransitNumber": "217555555",
"BankAccountNumber": "0000000001",
"AccountType": "Checking",
"ReqPaymentDate": "12/31/2025"
}
}
}
],
"Errors": null
}
Bad Request Response - You'll get the below response when your API requests contain any validation errors.
{
"StatusCode": "400",
"StatusName": "BadRequest",
"StatusMessage": "Validation error has occurred",
"SubmissionId": null,
"StateWHRecords": null,
"Errors": [
{
"Id": "S00-000098",
"Name": "SubmissionId",
"Message": "SubmissionId is invalid."
}
]
}
Unauthorized Response - You'll get the below response when your API requests don't contain valid authentication credentials.
{
"StatusCode": 401,
"StatusName": "Unauthorized",
"StatusMessage": "Invalid authorization credentials",
"Errors": [
{
"Id": "AUTH-100018",
"Name": "Authorization",
"Message": "JWT EXPIRED"
}
]
}