Get

Get

Use this endpoint to retrieve the information of a previously created Iowa Withholding Report form for the corresponding employer (payer). Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the forms.

POST StateFilings/IAWH/Get 

Run in Postman

Request Body

Field	Type	Description
SubmissionId	Guid	Unique identifier of a submission.
RecordId	Guid	An unique identifier generated by TaxBandits when a IA44095 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.
StateWHRecords	Object[]	Object to identify the records.
SequenceId	String	A unique identifier for this record.
RecordId	Guid	A unique identifier generated by TaxBandits when a IA44095 return is created.
ReturnHeader	Object	Contains business information.
TaxYear	String	The tax year for which the Form IA44095 is to be filed.
Qtr	String	The quarter for which the Form IA44095 is to be filed.
Business	object	Object to identify the Business Details.
BusinessId	Guid	Use the unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint. If you do not have a Business ID, ignore the field. By giving the Business ID, you do not have to provide all the business information again.
PayerRef	string	Your unique identifier for the payer. Can replace BusinessId in future requests.
IsDefaultBusiness	Boolean	When set to TRUE, this business will be set as the default across requests that do not specify a business.
TINDetails	object	TIN information for the business.
Format	string	Specifies how the TIN is passed.
TINType	string	Specify the TIN type of the business.
TIN	string	The TIN value according to the Format selected.
BusinessNm	string	Legal name of the business. Required when TINType is EIN.
NameCtrl	string	Name control of the business as registered with the IRS.
DBADetails	object	DBA (Doing Business As) information.
DBANm	string	Name of the DBA.
DBARef	string	Unique identifier for the DBA.
DBAId	Guid	TaxBandits-generated DBA identifier.
Address	object	Address information of the DBA.
Address1	string	Street address or PO Box.
Address2	string	Suite or apartment number.
City	string	DBA's city.
ProvinceOrState	string	DBA's province or state name.
Zipcd	string	DBA's ZIP code.
Country	string	DBA's 2-character country code
Address	object	Primary address of the business.
Address1	string	Street address or PO Box of the business.
Address2	string	Suite or apartment number of the business.
City	string	City of the business.
ProvinceOrState	string	Province or state name of the business.
ZipCd	string	ZIP code of the business.
Country	string	2-character country code of the business.
ContactDetails	object	Details of the person the IRS can contact regarding the given business.
FirstNm	string	First name of the contact person.
MiddleNm	string	Middle name of the contact person.
LastNm	string	Last name of the contact person.
Suffix	string	The suffix of the contact person
Phone	string	Phone number of the contact person.
PhoneExtn	string	Phone extension number.
Email	string	Email address of the contact person.
Fax	string	Fax number of the contact person.
BusinessType	String	Legal structure of the business.
SigningAuthority	Object	Details of the person authorized to sign the return.
FirstNm	String	First name of the signatory.
MiddleNm	String	Middle name of the signatory.
LastNm	String	Last name of the signatory.
Suffix	String	The suffix of the signatory.
Phone	String	Phone number of the signatory
PhoneExtn	String	Phone extension number of the signatory.
BusinessMemberType	String	Title or role of the signatory.
ReturnData	Object	Contains the return information.
IA44095	Object	Identifies the Form Iowa data.
WHIdNumber	String	Iowa withholding file number. Sample Format: XXXXXXXXX Size Range: 9
IsChangeOfAddress	Boolean	Optional When true, it indicates there is a change of the address. Note: The Business Address associated with the Business ID will be used as the updated address.
IsNoWageReported	Boolean	Optional When true, indicates that no wage is reported in this quarter.
DepositScheduleType	String	Deposit schedule type of the IA44095. Allowed values "MONTHLY", "SEMI_MONTHLY", "QUARTERLY"
TotalTaxWithheld	Number	Optional Total tax withheld from all sources for the filing period. Size Range: 0-999999999999999999.99
DepositsOrOverpayments	Number	Optional Monthly deposits or overpayments. Size Range: 0-999999999999999999.99
NewJobsCredits	Object	Optional Object that contains New Jobs Credit details.
CertificateNumber	String	Optional Certificate number of new job credit. Size Range: 12
Amount	Number	Optional Total new job credit amount. Size Range: 0-999999999999999999.99
SupplementalJobsCredit	Object	Optional Object that contains Supplemental job credit details.
CertificateNumber	String	Optional Certificate number for Supplemental job credit. Size Range: 12
Amount	Number	Optional Total Supplemental job credit amount. Size Range: 0-999999999999999999.99
AcceleratedCareerEducationCredit	Object	Optional Object that contains accelerated career education credit details.
CertificateNumber	String	Optional Certificate number of accelerated career education credit.
Amount	Number	Optional Total accelerated career education credit amount. Size Range: 0-999999999999999999.99
TargetedJobsCredit	Object	Optional Object that contains Targeted Jobs Credit details.
CertificateNumber	String	Optional Certificate number of Targeted Jobs Credit.
Amount	Number	Optional Total Targeted Jobs Credit amount. Size Range: 0-999999999999999999.99
TotalCreditAmount	Number	Optional Total Credit amount. Size Range: 0-999999999999999999.99
MonthlyLiability	Object	Optional Object that contains tax liable details if the tax deposit schedule given is "MONTHLY".
Month1TaxLiability	Number	Optional Tax total liability amount for month 1 of the quarter. Size Range: 0-999999999999999999.99
Month2TaxLiability	Number	Optional Tax total liability amount for month 2 of the quarter. Size Range: 0-999999999999999999.99
Month3TaxLiability	Number	Optional Tax total liability amount for month 3 of the quarter. Size Range: 0-999999999999999999.99
BalanceDue	Number	Optional Balance due for the quarter. Size Range: 0-999999999999999999.99
Penalty	Number	Optional Penalties for the quarter. Size Range: 0-999999999999999999.99
Interest	Number	Optional Total interest amount for the quarter. Size Range: 0-999999999999999999.99
TotalDue	Number	Optional Total amount due for the quarter. Size Range: 0-999999999999999999.99
SemiMonthlyDeposit	Object	Optional Object that contains tax deposit details if the tax deposit schedule given is "SEMI_MONTHLY".
TaxLiability1	Number	Optional The tax liability amount for the first liability period. Size Range: 0-999999999999999999.99
TaxLiability2	Number	Optional The tax liability amount for the second liability period. Size Range: 0-999999999999999999.99
TaxLiability3	Number	Optional The tax liability amount for the third liability period. Size Range: 0-999999999999999999.99
TaxLiability4	Number	Optional The tax liability amount for the fourth liability period. Size Range: 0-999999999999999999.99
TaxLiability5	Number	Optional The tax liability amount for the fifth liability period. Size Range: 0-999999999999999999.99
TaxLiability6	Number	Optional The tax liability amount for the sixth liability period. Size Range: 0-999999999999999999.99
TaxLiability7	Number	Optional The tax liability amount for the seventh liability period. Size Range: 0-999999999999999999.99
TotalTaxLiability	Number	Optional The total tax liability amount for the quarter. Size Range: 0-999999999999999999.99
StatePayment	Object	Optional Object that contains information about the payment details.
AccountType	String	Optional Bank account type. Allowed values "CHECKING", "SAVING"
BankName	String	Optional Bank account name of payment. Size Range: 1-30
BankRoutingTransitNumber	String	Optional Bank Routing Number of payment. Size Range: 9
BankAccountNumber	String	Optional Bank Account Number for payment. Size Range: 1-17
PaymentAmount	Number	Optional Amount to be paid. Size Range: 0-9999999999.99
PaymentRequestDate	String	Optional Date when the payment has to be made. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY. Example: 01/25/2026
Errors	Object[]	Shows detailed error information.
Id	string	Total due amount.
Name	string	Name of the validation error.
Message	string	Description of the validation error.

Request JSON

"statefilings/iawh/Get?RecordId=f5c0b155-7261-4f9d-b0bc-cad7a0f69d2e&SubmissionId=01993c45-e77e-7383-823a-d13273fd717c"

Response JSON

200

Success Response - This is a sample response for successful API requests.

{
"SubmissionId": "01a01f04-5db4-7559-8aa7-b0d84d1be0c0",
"StateWHRecords": [
  {
    "SequenceId": "001",
    "RecordId": "01a01f04-5ece-7658-9c42-81d1df5bfbdb",
    "ReturnHeader": {
      "Qtr": "Q2",
      "TaxYear": "2026",
      "Business": {
        "BusinessId": "6c173fe1-141c-4737-a621-8fa511cb6a26",
        "PayerRef": null,
        "IsDefaultBusiness": true,
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-2270916"
        },
        "IndividualNm": null,
        "BusinessNm": "Snowdaze LLC",
        "NameCtrl": "FIRE",
        "DBADetails": {
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "DBAId": "3D09270B-7347-4236-9357-D5AB1EA3AD44",
          "Address": {
            "Address1": "123 Main St",
            "Address2": "Suite 1001",
            "City": "Rock Hill",
            "ProvinceOrState": "MN",
            "ZipCd": "55001",
            "Country": "US"
          }
        },
        "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "MN",
          "ZipCd": "55001",
          "Country": "US"
        },
        "ContactDetails": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr",
          "Phone": "(803) 555-1234",
          "PhoneExtn": "101",
          "Email": "contact@snowdaze.com",
          "Fax": "(803) 555-5678"
        },
        "BusinessType": "ESTE",
        "SigningAuthority": {
          "FirstNm": "Ambrane",
          "MiddleNm": "A",
          "LastNm": "Cavil",
          "Suffix": "Jr",
          "Phone": "(803) 555-1000",
          "PhoneExtn": "12345",
          "BusinessMemberType": "ADMINISTRATOR"
        },
        "KindOfEmployer": null,
        "KindOfPayer": null
      }
    },
    "ReturnData": {
      "IA44095": {
        "WHIdNumber": "999999999999",
        "IsChangeOfAddress": false,
        "IsNoWageReported": false,
        "DepositScheduleType": "MONTHLY",
        "TotalTaxWithheld": "0.00",
        "DepositsOrOverpayments": "0.00",
        "NewJobsCredit": {
          "CertificateNumber": null,
          "Amount": "0.00"
        },
        "SupplementalJobsCredit": {
          "CertificateNumber": null,
          "Amount": "0.00"
        },
        "AcceleratedCareerEducationCredit": {
          "CertificateNumber": null,
          "Amount": "0.00"
        },
        "TargetedJobsCredit": {
          "CertificateNumber": null,
          "Amount": "0.00"
        },
        "TotalCreditAmount": "0.00",
        "MonthlyDeposit": {
          "Month1TaxLiability": "0.00",
          "Month2TaxLiability": "0.00",
          "Month3TaxLiability": "0.00"
        },
        "BalanceDue": "0.00",
        "Penalty": "0.00",
        "Interest": "0.00",
        "TotalDue": "0.00",
        "SemiMonthlyDeposit": {
          "TaxLiability1": "0.00",
          "TaxLiability2": "0.00",
          "TaxLiability3": "0.00",
          "TaxLiability4": "0.00",
          "TaxLiability5": "0.00",
          "TaxLiability6": "0.00",
          "TaxLiability7": "0.00"
        },
        "TotalTaxLiability": "0.00"
      },
      "StatePayment": {
        "BankName": "XYZ",
        "PaymentAmount": "100",
        "BankRoutingTransitNumber": "217555555",
        "BankAccountNumber": "0000000001",
        "AccountType": "Checking",
        "PaymentRequestDate": "MM/DD/YYYY"
      }
    }
  }
],
"Errors": null
}