Get
Get
Use this endpoint to retrieve the information of a previously created A1-QRT form for the corresponding business. Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the forms.
GET StateFilings/A1QRTWH/Get Request Params
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier created by TaxBandits for each submission. Not required when you are creating a return |
| RecordId | Guid | A unique identifier generated by TaxBandits when a A1-QRT return is created. Mention the return's Record ID that you want to get. |
Response Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier created by TaxBandits for each submission. Not required when you are creating a return. |
| StateWHRecords | Object [] | Object to create A1-QRT |
| SequenceId | String | A unique number given by an inbound application to identify failed records. Size Range: ..10 |
| ReturnHeader | Object | Identifies the supporting details of Form A1-QRT. |
| Qtr | String | The Quarter for which Form A1-QRT needs to be filed.Allowed values"Q1", "Q2", "Q3", "Q4" |
| TaxYr | String | The tax year for which Form A1-QRT needs to be filed.Allowed values2025 |
| BusinessId | String | Optional Use the unique BusinessId (Generated by TaxBandits) you receivedin the response of the Business CREATE Endpoint. If you do not have aBusinesId, ignore the field. By giving the BusinessId, you do not have toprovide all the business information again. |
| Business | Object | The details of the business you’re filing for. |
| BusinessNm | String | Name of the business. Size Range: ..75 |
| PayerRef | string | Optional An unique identifier for each payer completing their information.This identifier can be used in future references of the payer in the API. Size Range: ..50 |
| 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 Employer Identification Number (EIN). When IsEIN isfalse, use Social Security Number (SSN). Size Range: 9-11 |
| String | Email address of the business. Size Range: ..100 | |
| IsForeign | Boolean | When true, identifies the business as having a foreign address. |
| USAddress | Object | If IsForeign is false, pass the US address of the business. |
| Address1 | String | Employer/Payer’s US address (street address or post office box). 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. Size Range: 2 Allowed valuesAL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI","ID", "IL", "IN", etc. |
| 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). 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", etc. |
| PostalCd | String | Employer/Payer’s postal code. Size Range: ..16 |
| ReturnData | Object[] | Identifies the Form A1-QRT data. |
| FormA1Qrt | Object | Arizona withholding quarterly tax return. |
| IsChangeOfAdd | Boolean | If true, indicates that the employer needs to change the address |
| IsFinalReturn | Boolean | If true, indicates that this is the employer’s final return.Note: The Department of Arizona will cancel your withholding account if this is your final return |
| FinalReturnDetails | Object | Object that contains information of final return details |
| WHAccCloseDate | String | Date on which final wages were paid. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY (Example: 01/25/2025). |
| IsReorgOrEntityChange | Boolean | If true, indicates that final return is due to reorganization or change in business entity |
| IsBusinessSold | Boolean | If true, indicates that final return is due to business has been sold |
| IsStoppedPayingWages | Boolean | If true, indicates that final return is due to business stopped paying wages and will not have any employees in the future. |
| IsPermClosed | Boolean | If true, indicates that final return is due to business is permanently closed |
| IsLeasedOrTempEmployees | Boolean | If true, indicates that final return is due to business has only leased or temporary agency employees |
| IsOther | Boolean | If true, indicates that final return is due to other reasons |
| OtherReason | String | Other reason for filing the final return, other than the reasons given above. |
| IsFiledBySurvEmployer | Boolean | If true, indicates that the return is filed by the surviving employer |
| SurvEmployerDetails | Object | Object that contains information of surviving employer details |
| Name | String | Predecessor employer's nameSize Range: ..46* |
| EIN | String | EIN of the predecessor employerSize Range:9* |
| IsRecLocDiff | Boolean | If true, indicates that records will be maintained at an address different from the business address |
| DiffLocDetails | Object | Object that contains different location address were records will be maintained |
| Name | String | Name of the address were records will be maintained Size Range: ..46 |
| Address1 | String | US address (street address or post office box). Size Range: ..46 |
| Address2 | String | Optional suite or apartment. Size Range: ..46 |
| City | String | City where records will be maintained Size Range: ..50 |
| State | String | State where records will be maintained Size Range: 2Allowed values"AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI","ID", "IL", "IN", etc. |
| ZipCd | String | zip code. Size Range: 5..10 |
| IsSuccEmployer | Boolean | If true indicates that there is a successor employer for for the business. |
| SuccEmployerDetails | Object | Object that contains the successor employer details |
| Name | String | Name of the successor employer Size Range: ..46 |
| EIN | String | EIN of the successor employer Size Range: 9 |
| Address1 | String | successor employer’s US address (street address or post office box). Size Range: ..46 |
| Address2 | String | Optional successor employer’s suite or apartment. Size Range: ..46 |
| City | String | successor employer’s city. Size Range: ..50 |
| State | String | successor employer’s state. Size Range: 2Allowed values"AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI","ID", "IL", "IN", etc. |
| ZipCd | String | successor employer’s zip code. Size Range: 5..10 |
| TotPayrollAmt | Number | Total Arizona taxable wages paid for the quarter. Size Range: 0-999999999.99 |
| TotEmpPaid | Number | Total number of employees paid Arizona wages for this quarterSize Range: 0-9999999* |
| DepositSchType | String | Enter the tax liability schedule for Arizona withholding reportingAllowed values"QUARTERLY","MONTHLY","SEMI_WEEKLY", "NEXT_DAY" |
| A1TaxLiabilityAmt | Number | If tax liability schedule is "QUARTERLY" then enter the Quarterly tax liability amount for the quarter. Size Range: 0-999999999.99 |
| MonthlyLiability | object | Object that contains tax liability details if the tax liability schedule given is "MONTHLY" |
| B1Month1LiabilityAmt | Number | Tax liability amount for month 1 of the quarter. Size Range: 0-999999999.99 |
| B2Month2LiabilityAmt | Number | Tax liability amount for month 2 of the quarter. Size Range: 0-999999999.99 |
| B3Month3LiabilityAmt | Number | Tax liability amount for month 3 of the quarter. Size Range: 0-999999999.99 |
| B4TotLiabilityAmt | Number | Total Tax liability amount for all the months of the quarter. Size Range: 0-999999999.99 |
| SemiWeeklyOrNxtDayLiability | Object | Object that contains tax liability details if the tax liability schedule given is either "SEMI_WEEKLY" or "NEXT_DAY" |
| Month1TaxLiability | Object | Object that contains tax liability details for month 1 of the quarter |
| Day | String | Day on which the tax amount is depositedAllowed values"01","02","03","04","05","06","07","08","09","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31" |
| Amt | Number | Tax liability amount deposited Size Range: 0-999999999.99 |
| IsNextDayDeposit | Boolean | If true indicates that the tax liability schedule is "NEXT_DAY" |
| Month1TotLiability | Number | Total tax liability amount deposited on month 1 of the quarterSize Range: 0-999999999.99 |
| Month2TaxLiability | Object | Object that contains tax liability details for month 2 of the quarter |
| Day | String | Day on which the tax amount is depositedAllowed values"01","02","03","04","05","06","07","08","09","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31" |
| Amt | Number | Tax liability amount deposited *Size Range: 0-999999999.99 |
| IsNextDayDeposit | Boolean | If true indicates that the tax liability schedule is "NEXT_DAY" |
| Month2TotLiability | Number | Total tax liability amount deposited on month 2 of the quarter Size Range: 0-999999999.99 |
| Month3TaxLiability | Object | Object that contains tax liability details for month 3 of the quarter |
| Day | String | Day on which the tax amount is depositedAllowed values"01","02","03","04","05","06","07","08","09","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31" |
| Amt | Number | Tax liability amount deposited Size Range: 0-999999999.99 |
| IsNextDayDeposit | Boolean | If true indicates that the tax liability schedule is "NEXT_DAY" |
| Month3TotLiability | Number | Total tax liability amount deposited on month 3 of the quarter Size Range: 0-999999999.99 |
| L1LiabilityAmt | Number | Total tax liability amount deposited *Size Range: 0-999999999.99v |
| L2TotDepositAmt | Number | Total deposits or payments made during this quarter Size Range: 0-999999999.99 |
| L3TotAmtDue | Number | Total amount due for the quarter *Size Range: 0-999999999.99v |
| StatePayment | Object | Object that contains information about payment details for the department of Arizona |
| AccountType | String | Type of the bank account.Allowed values"PERSONAL_CHECKING", "PERSONAL_SAVINGS", "BUSINESS_SAVINGS", "BUSINESS_CHECKING" |
| BankRoutingNum | String | Bank routing number Size Range: 9 |
| BankAccountNum | String | Bank Account Number Size Range: ..17 |
| PaymentAmt | Number | Amount to be paid to the department of North Carolina Size Range: 0-99999999.99 |
| AccHolderNm | String | Name of the bank account holder Size Range: ..22 |
| ReqPaymentDate | String | Date on which the payment is requested. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY (Example: 01/25/2025). |
Request Params
"StateFilings/A1QRTWH/Get?RecordId=01999580-9061-77d5-86be-bc5686a6a5a5&SubmissionId=0199c8cc-6d8a-77a7-b401-aed04901d431"
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": "019c7082-6a57-7559-a5e9-ae56a6c1f08a",
"StateWHRecords": [
{
"Sequence": "001",
"RecordId": "019c7082-6b49-715f-9a2e-bd11f4df742b",
"ReturnHeader": {
"Qtr": "Q4",
"TaxYr": "2025",
"Business": {
"BusinessId": "c2fc9f86-8673-4cad-870c-36f8e4831455",
"BusinessNm": "Snowdaze LLC",
"PayerRef": null,
"FirstNm": null,
"MiddleNm": null,
"LastNm": null,
"Suffix": null,
"TradeNm": "Iceberg Icecreams",
"IsEIN": true,
"EINorSSN": "23-4347837",
"Email": "james@sample.com",
"ContactNm": "James Smith",
"Phone": "(653) 456-7890",
"PhoneExtn": "123",
"Fax": "(983) 456-7890",
"BusinessType": "ESTE",
"SigningAuthority": {
"Name": "James Smith",
"Phone": "(993) 456-7890",
"BusinessMemberType": "ADMINISTRATOR"
},
"KindOfEmployer": "FEDERALGOVT",
"KindOfPayer": "REGULAR941",
"IsBusinessTerminated": false,
"IsForeign": false,
"USAddress": {
"Address1": "3576 AIRPORT WAY",
"Address2": "UNIT 9",
"City": "FAIRBANKS",
"State": "AK",
"ZipCd": "99709"
},
"ForeignAddress": null,
"ACADetails": null
}
},
"ReturnData": {
"FormA1QRT": {
"IsAmendedReturn": false,
"IsChangeOfAdd": false,
"IsFinalReturn": true,
"FinalReturnDetails": {
"WHAccCloseDate": "01/10/2025",
"IsReorgOrEntityChange": true,
"IsBusinessSold": false,
"IsStoppedPayingWages": false,
"IsPermClosed": false,
"IsLeasedOrTempEmployees": false,
"IsOther": false,
"OtherReason": null
},
"IsFiledBySurvEmployer": false,
"SurvEmployerDetails": null,
"IsRecLocDiff": true,
"DiffLocDetails": {
"Name": "GHGH",
"Address1": "71 Saint Nicholas Dr",
"Address2": null,
"City": "Northpole",
"State": "AK",
"ZipCd": "99705"
},
"IsSuccEmployer": false,
"SuccEmployerDetails": null,
"TotPayrollAmt": 1100,
"TotEmpPaid": 100,
"DepositSchType": "SEMIWEEKLY",
"A1TaxLiabilityAmt": 110,
"MonthlyLiability": {
"B1Month1LiabilityAmt": 110,
"B2Month2LiabilityAmt": 110,
"B3Month3LiabilityAmt": 110,
"B4TotLiabilityAmt": 330
},
"SemiWeeklyOrNxtDayLiability": {
"Month1TaxLiability": [
{
"Day": "1",
"Amt": 50,
"IsNextDayDeposit": true
},
{
"Day": "2",
"Amt": 60,
"IsNextDayDeposit": true
}
],
"Month2TaxLiability": [
{
"Day": "1",
"Amt": 50,
"IsNextDayDeposit": true
},
{
"Day": "2",
"Amt": 60,
"IsNextDayDeposit": true
}
],
"Month3TaxLiability": [
{
"Day": "1",
"Amt": 50,
"IsNextDayDeposit": true
},
{
"Day": "2",
"Amt": 60,
"IsNextDayDeposit": true
}
],
"Month1TotLiability": 110,
"Month2TotLiability": 110,
"Month3TotLiability": 110
},
"L1LiabilityAmt": 330,
"L2TotDepositAmt": 110,
"L3TotAmtDue": 220,
"StatePayment": {
"BankRoutingNum": "786543457",
"AccountType": "CHECKING",
"BankAccountNum": "73456765432123456",
"PaymentAmt": 100,
"AccHolderNm": "John",
"ReqPaymentDate": "10/10/2026"
}
}
}
}
],
"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"
}
]
}