Skip to main content
Version: 2.0.0

Get

Get

Use this endpoint to retrieve the information of a previously created G-7M/G-7Q form for the corresponding business. Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the forms.

POST StateFilings/G7WH/Get 

Request Body

FieldTypeDescription
SubmissionIdGuidUnique identifier created by TaxBandits for each submission.
RecordIdGuidAn unique identifier generated by TaxBandits when a G-7M/G-7Q return is created. Mention the return's Record ID that you want to get.

Response Body

FieldTypeDescription
SubmissionIdGuidUnique identifier created by TaxBandits for each submission.
StateWHRecordsObject[]Object to identify the records.
SequenceIdStringA unique identifier for this record.
RecordIdGuidA unique identifier generated by TaxBandits when a G-7M/G-7Q return is created.
ReturnHeaderObjectContains business information.
TaxYearStringThe tax year for which the Form G-7 is to be filed.
QtrStringThe quarter for which the Form G-7 is to be filed.
BusinessobjectObject to identify the Business Details.
BusinessIdGuidThe unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint.
PayerRefstringYour unique identifier for the payer. Can replace BusinessId in future requests.
IsDefaultBusinessBooleanWhen set to TRUE, this business will be set as the default across requests that do not specify a business.
TINDetailsobjectTIN information for the business.
FormatstringSpecifies how the TIN is passed.
TINTypestringSpecify the TIN type of the business.
TINstringThe TIN value according to the Format selected.
IndividualNmobjectRequired when TINType is SSN. Provide individual name fields instead of BusinessNm.
FirstNmstringThe first name of the individual.
MiddleNmstringMiddle name of the individual.
LastNmstringThe last name of the individual.
SuffixstringSuffix of the individual's name.
BusinessNmstringLegal name of the business.
NameCtrlstringName control of the business as registered with the IRS.
DBADetailsobject[]DBA (Doing Business As) information.
DBANmstringName of the DBA.
DBARefstringUnique identifier for the DBA.
DBAIdGuidTaxBandits-generated DBA identifier.
Addressobject[]Address information of the DBA.
Address1stringStreet address or PO Box.
Address2stringSuite or apartment number.
CitystringDBA's city.
ProvinceOrStatestringDBA's province or state name.
ZipcdstringDBA's ZIP code.
CountrystringDBA's 2-character country code.
EmailstringEmail address of the Business.
AddressobjectPrimary address of the business.
Address1stringStreet address or PO Box of the business.
Address2stringSuite or apartment number of the business.
CitystringCity of the business.
ProvinceOrStatestringProvince or state name of the business.
ZipCdstringZIP code of the business.
Countrystring2-character country code of the business.
ContactDetailsobject[]Details of the person the IRS can contact regarding the given business.
FirstNmstringFirst name of the contact person.
MiddleNmstringMiddle name of the contact person.
LastNmstringLast name of the contact person.
SuffixstringThe suffix of the contact person.
Allowed values

"Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"

PhonestringPhone number of the contact person.
PhoneExtnstringPhone extension number.
EmailstringEmail address of the contact person.
FaxstringFax number of the contact person.
SigningAuthorityObjectDetails of the person authorized to sign the return.
FirstNmStringFirst name of the signatory.
MiddleNmStringMiddle name of the signatory.
LastNmStringLast name of the signatory.
SuffixStringThe suffix of the signatory.
PhoneStringPhone number of the signatory.
PhoneExtnStringPhone extension number of the signatory.
BusinessMemberTypeStringTitle or role of the signatory.
ReturnDataObjectIdentifies the Form G-7 data.
FormG7MobjectInformation of Form G7-M, Quarterly Return for Monthly Payer Worksheet.
DepositSchTypstringDeposit Schedule of the Payer.
WHIdNumStringGeorgia withholding ID number.
Month1TaxObjectObject to identify month 1 tax details.
TotTaxWHNumberTotal Georgia income tax withheld for the month 1.
WHAdjObjectGets Withholding Tax Adjustments details.
AddnlTaxNumberAdditional Tax Adjustment for Month 1.
OverPaymentNumberOverpayment Adjustment for Month 1.
CreditCd1StringVariable Best Credit One for Month 1.
CreditAmt1NumberVariable Best Credit One Amount for Month 1.
CreditCd2StringVariable Best Credit Two for Month 1.
CreditAmt2NumberVariable Best Credit Two Amount for Month 1.
TaxAdjNumberTotal Tax Adjustments for Month 1.
TaxDueNumberTotal Tax Due for Month 1.
TaxPaidNumberTotal Tax Paid for Month 1.
Month2TaxObjectObject to identify month 2 tax details.
TotTaxWHNumberTotal Georgia income tax withheld for the month 2.
WHAdjObjectGets Withholding Tax Adjustments details.
AddnlTaxNumberAdditional Tax Adjustment for Month 2.
OverPaymentNumberOverpayment Adjustment for Month 2.
CreditCd1StringVariable Best Credit One for Month 2.
CreditAmt1NumberVariable Best Credit One Amount for Month 2.
CreditCd2StringVariable Best Credit Two for Month 2.
CreditAmt2NumberVariable Best Credit Two Amount for Month 2.
TaxAdjNumberTotal Tax Adjustments for Month 2.
TaxDueNumberTotal Tax Due for Month 2.
TaxPaidNumberTotal Tax Paid for Month 2.
Month3TaxObjectObject to identify month 3 tax details.
TotTaxWHNumberTotal Georgia income tax withheld for the month 3.
WHAdjObjectGets Withholding Tax Adjustments details.
AddnlTaxNumberAdditional Tax Adjustment for Month 3.
OverPaymentNumberOverpayment Adjustment for Month 3.
CreditCd1StringVariable Best Credit One for Month 3.
CreditAmt1NumberVariable Best Credit One Amount for Month 3.
CreditCd2StringVariable Best Credit Two for Month 3.
CreditAmt2NumberVariable Best Credit Two Amount for Month 3.
TaxAdjNumberTotal Tax Adjustments for Month 3.
TaxDueNumberTotal Tax Due for Month 3.
TaxPaidNumberTotal Tax Paid for Month 3.
SemiWeeklyDepositorObjectObject to identify the semi weekly deposit schedule details.
Month1TaxLiabObject[]Object to identify the tax liability details for the first month of the quarter.
DayStringTax Liability pay day of first month of the quarter.
AmtNumberTax liability amount of the pay day.
TotMonth1TaxLiabNumberTotal tax required to be withheld for first month of quarter. Size Range: 0-99999999.99
Month2TaxLiabObject[]Object to identify the tax liability details for the second month of the quarter.
DayStringTax Liability pay day of second month of the quarter.
AmtNumberTax liability amount of the pay day.
TotMonth2TaxLiabNumberTotal tax required to be withheld for second month of quarter.
Month3TaxLiabObject[]Object to identify the tax liability details for the third month of the quarter.
DayStringTax Liability pay day of third month of the quarter.
AmtNumberTax liability amount of the pay day.
TotMonth3TaxLiabNumberTotal tax required to be withheld for third month of quarter.
TotTaxLiabNumberTotal tax required to be withheld for all the months of the quarter.
QuarterlyTotNumberTotal withheld of the quarter.
TotTaxPaidNumberTotal tax paid for the quarter.
AdjDescstringExplanation for the adjustments given quarter.
FormG7QobjectInformation of Form G7-Q, Quarterly Return for Quarterly Payer Worksheet.
WHIdNumStringGeorgia withholding ID number.
TotTaxWHNumberTotal Georgia income tax withheld for the quarter.
TaxAdjNumberTotal Tax Adjustments for the quarter.
TotWHDueNumberTotal Tax Due for the quarter.
TotTaxPaidNumberTotal Tax Paid for the quarter.
AdjDescstringExplanation for the adjustments given quarter.
ErrorsObject[]Shows detailed error information.
IdstringReturns the validation error ID.
NamestringName of the validation error.
MessagestringDescription of the validation error.

Request JSON​

"statefilings/g7wh/Get?SubmissionId=01a0e74f-efb0-7496-9ab3-9c53f8076266&RecordId=01a0e74f-f13e-73a9-acc6-7feed812b652"

Response JSON​

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

{
"SubmissionId": "01a0e74f-efb0-7496-9ab3-9c53f8076266",
"StateWHRecords": [
{
"SequenceId": "001",
"RecordId": "01a0e74f-f13e-73a9-acc6-7feed812b652",
"ReturnHeader": {
"Qtr": "Q3",
"TaxYear": "2026",
"Business": {
"BusinessId": "e9b210bc-8fc7-4c2f-8b19-8ce978770a0a",
"PayerRef": null,
"IsDefaultBusiness": true,
"TINDetails": {
"Format": "PLAIN_TIN",
"TINType": "EIN",
"TIN": "45-9875401"
},
"BusinessNm": "Snowdaze LLC",
"DBADetails": {
"DBANm": "Iceberg Icecreams",
"DBARef": "DBA1001",
"DBAId": "D6E518AD-F369-4F36-AED4-FFD554498C53",
"Address": {
"Address1": "123 Main St",
"Address2": "Suite 1001",
"City": "Rock Hill",
"ProvinceOrState": "SC",
"ZipCd": "29730",
"Country": "US"
}
},
"Address": {
"Address1": "123 Main St",
"Address2": "Suite 1001",
"City": "Rock Hill",
"ProvinceOrState": "SC",
"ZipCd": "29730",
"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": "111",
"BusinessMemberType": "ADMINISTRATOR"
},
"KindOfEmployer": null,
"KindOfPayer": null
}
},
"ReturnData": {
"FormG7Q": null,
"FormG7M": {
"DepositSchTyp": "MONTHLY",
"WHIdNum": "1231231-AB",
"Month1Tax": {
"TotTaxWH": 1000,
"TaxAdj": 200,
"WHAdj": {
"BalanceDue": 500,
"OverPayment": 100,
"CreditCd1": "RSCHTXCRD",
"CreditAmt1": 100,
"CreditCd2": "QLJOBSCRD",
"CreditAmt2": 100
},
"TaxDue": 1200,
"TaxPaid": 900
},
"Month2Tax": {
"TotTaxWH": 1000,
"TaxAdj": 200,
"WHAdj": {
"BalanceDue": 500,
"OverPayment": 100,
"CreditCd1": "RSCHTXCRD",
"CreditAmt1": 100,
"CreditCd2": "QLJOBSCRD",
"CreditAmt2": 100
},
"TaxDue": 1200,
"TaxPaid": 900
},
"Month3Tax": {
"TotTaxWH": 1000,
"TaxAdj": 200,
"WHAdj": {
"BalanceDue": 500,
"OverPayment": 100,
"CreditCd1": "RSCHTXCRD",
"CreditAmt1": 100,
"CreditCd2": "QLJOBSCRD",
"CreditAmt2": 100
},
"TaxDue": 1200,
"TaxPaid": 900
},
"SemiWeeklyDepositor": null,
"QuarterlyTot": 3000,
"TotTaxPaid": 2700,
"AdjDesc": "Due to tax"
}
}
}
],
"Errors": null
}