Get

Get

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

POST StateFilings/DCFR900Q/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 FR-900Q 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 FR-900Q return is created.
ReturnHeader	Object	Contains business information.
TaxYear	String	The tax year for which the Form FR900Q is to be filed.
Qtr	String	The quarter for which the Form FR900Q is to be filed.
Business	object	Object to identify the Business Details.
BusinessId	Guid	The unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint.
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.
IndividualNm	object	Required when TINType is SSN. Provide individual name fields instead of BusinessNm.
FirstNm	string	The first name of the individual.
MiddleNm	string	Middle name of the individual.
LastNm	string	The last name of the individual.
Suffix	string	Suffix of the individual's name.
BusinessNm	string	Legal name of the business.
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.
Email	string	Email address of the Business.
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. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
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.
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[]	Identifies the Form FR-900Q data.
FormFR900Q	Object	DC withholding quarterly tax return.
WHIdNum	String	DC withholding ID number issued by the DC Office of Tax and Revenue. Size Range: 12
IsBusinessClosed	Boolean	When true, indicates that the business has been closed. When set to true, LastPayrollDt is required and all other Form FR-900Q nodes should be null.
LastPayrollDt	String	Last payroll date on which wages were paid before the business closed.
IsDiffMailAddr	Boolean	When true, indicates that the mailing address is different from the business address. When true, MailAddress is required.
MailAddress	Object	Mailing address of the business.
Address1	string	Street address or PO Box.
Address2	string	Suite or apartment number.
City	string	City of the mailing address.
ProvinceOrStateNm	string	Province or state name.
Zipcd	string	ZIP code.
Country	string	Country of the mailing address. Note: Only country code "US" is allowed.
TotTaxWH	Number	Total DC income tax withheld for the quarter. Size Range: 0-999999999.99
IsMonthlyPayer	Boolean	When true, identifies the payer as a monthly filer. When true, Month1TaxWH, Month2TaxWH, and Month3TaxWH are required and their sum must equal TotTaxWH.
Month1TaxWH	Number	DC income tax withheld for the first month of the quarter. Size Range: 0-999999999.99
Month2TaxWH	Number	DC income tax withheld for the second month of the quarter. Size Range: 0-999999999.99
Month3TaxWH	Number	DC income tax withheld for the third month of the quarter. Size Range: 0-999999999.99
TotTaxPaid	Number	Total tax deposit made for the quarter. Size Range: 0-999999999.99
TotWHDue	Number	Balance due amount when TotTaxWH is greater than TotTaxDeposit.
Overpayment	Number	Overpayment amount when TotTaxDeposit is greater than TotTaxWH.
OverPaymentRecoveryType	String	Indicates how the overpayment should be recovered.
IsThirdPartyDesignee	Boolean	When true, indicates that a third-party designee is authorized to discuss this return with the DC Office of Tax and Revenue.
ThirdPartyDesignee	Object	Details of the third-party designee.
Name	string	Name of the third-party designee.
Phone	string	Phone number of the third-party designee.
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/dcfr900qwh/get?SubmissionId=01a0e742-a1a5-73e8-9f70-9b28610865a3&RecordId=01a0e742-a30c-708f-a05f-dc3b070a162a"

Response JSON

200

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

{
"SubmissionId": "01a0e742-a1a5-73e8-9f70-9b28610865a3",
"StateWHRecords": [
  {
    "SequenceId": "001",
    "RecordId": "01a0e742-a30c-708f-a05f-dc3b070a162a",
    "ReturnHeader": {
      "Qtr": "Q1",
      "TaxYear": "2026",
      "Business": {
        "BusinessId": "f7fcb630-68f6-4d0b-acb4-3a00910c4d05",
        "PayerRef": null,
        "IsDefaultBusiness": true,
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "45-0070708"
        },
        "BusinessNm": "Snowdaze LLC",
        "DBADetails": {
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "DBAId": "CF483D60-7DAB-4455-AD91-19C04653AB42",
          "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": "FEDERALGOVT",
        "KindOfPayer": "REGULAR941"
      }
    },
    "ReturnData": {
      "FormFR900Q": {
        "WHIdNum": "300516556165",
        "IsBusinessClosed": true,
        "LastPayrollDt": "02/20/2025",
        "IsDiffMailAddr": true,
        "MailAddr": {
          "Address1": "210 Gervais Street",
          "Address2": "Floor 3",
          "City": "Columbia",
          "State": "SC",
          "ZipCd": "29204"
        },
        "TotTaxWH": 1500,
        "IsMonthlyPayer": true,
        "Month1TaxWH": 500,
        "Month2TaxWH": 500,
        "Month3TaxWH": 500,
        "TotTaxPaid": 2000,
        "TotWHDue": 0,
        "Overpayment": 500,
        "OverPaymentRecoveryType": "APPLYTORETURN",
        "IsThirdPartyDesignee": true,
        "ThirdPartyDesignee": {
          "Name": "Martin Bradley",
          "Phone": "8037654321"
        }
      }
    }
  }
],
"Errors": null
}