Version: 1.7.3

Update

Use this endpoint to update the information on existing FR-900Q forms that are already created for a specific employer (payer).

Note:

You cannot update a return once it has been transmitted.

PUTStateFilings/DCFR900Q/Update

Run in Postman

Request Body

Field	Type	Description
StateWHRecords	Object[]	Object to create Form FR-900Q
SequenceId	String	A unique number given by an inbound application to identify failed records. Size Range: ..50
RecordId	String	A unique identifier generated by TaxBandits when a Form IL 3/40 return is created. Size Range: ..50
ReturnHeader	Object	Identifies the supporting details of Form FR-900Q.
Qtr	String	The Quarter for which Form FR-900Q needs to be filed. Allowed values "Q1", "Q2", "Q3", "Q4"
TaxYr	String	The tax year for which Form FR-900Q needs to be filed. Allowed values 2025, 2026
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
Email	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: 5 Allowed values "ESTE", "PART", "SCORP", "CCORP", "EORG", "SPRO", "SLGOV"
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. 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 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. Must begin with "300". 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	Required when IsBusinessClosed is true. Last payroll date on which wages were paid before the business closed. Allowed values MM/DD/YYYY or MM-DD-YYYY
IsDiffMailAdd	Boolean	When true, indicates that the mailing address is different from the business address. When true, MailAddress is required.
MailAddress	Object	Required when IsDiffMailAdd is true. Mailing address of the business.
Address1	string	Mailing address (street or post office box). Size Range: ..46
Address2	string	Optional Mailing suite or apartment. Size Range: ..46
City	string	Mailing city. Size Range: ..50
State	string	Mailing state code. 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	Mailing zip code. Size Range: 5..10
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	Required when IsMonthlyPayer is true. DC income tax withheld for the first month of the quarter. Size Range: 0-999999999.99
Month2TaxWH	Number	Required when IsMonthlyPayer is true. DC income tax withheld for the second month of the quarter. Size Range: 0-999999999.99
Month3TaxWH	Number	Required when IsMonthlyPayer is true. DC income tax withheld for the third month of the quarter. Size Range: 0-999999999.99
TotTaxDeposit	Number	Total tax deposit made for the quarter. Size Range: 0-999999999.99
BalanceDue	Number	Optional Balance due amount when TotTaxWH is greater than TotTaxDeposit. Must equal (TotTaxWH - TotTaxDeposit). Size Range: 0-999999999.99
Overpayment	Number	Optional Overpayment amount when TotTaxDeposit is greater than TotTaxWH. Must equal (TotTaxDeposit - TotTaxWH). Size Range: 0-999999999.99
OverPaymentRecoveryType	String	Required when Overpayment has a value. Indicates how the overpayment should be recovered. Allowed values "APPLYTORETURN", "REFUND"
IsThirdPartyDesignee	Boolean	When true, indicates that a third-party designee is authorized to discuss this return with the DC Office of Tax and Revenue. When true, ThirdPartyDesignee is required.
ThirdPartyDesignee	Object	Required when IsThirdPartyDesignee is true. Details of the third-party designee.
Name	string	Name of the third-party designee. Size Range: ..75
Phone	string	Phone number of the third-party designee. Size Range: 10

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier for a submission.
SuccessRecords	object[]	Provides detailed information about the success status of Form UITR1 records.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the response for your reference.
BusinessId	Guid	Unique identifier for the business (payer) generated by TaxBandits.
PayerRef	string	Unique identifier for the business (payer) provided by you.
RecordId	Guid	A unique identifier generated by TaxBandits when a Form UITR1 return is created.
FormType	string	Type of form.
Status	string	Returns the record status.
StatusTs	string	Returns the date and time when the return was created.
Info	string	Provides additional information about the return.
Errors	object[]	Displays error information related to the state returns of Form UITR1.
Id	string	Returns the validation error ID.
Name	string	Name of the validation error.
ErrorRecords	object[]	Provides detailed information about the error status of Form UITR1 records.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the response for your reference.
RecordId	Guid	Unique identifier for the record.
Errors	object[]	Displays detailed error information.
Id	string	Returns the validation error ID.
Name	string	Name of the validation error.
Message	string	Description of the validation error.

Request JSON

{
    "SubmissionId": "019df72a-4d28-71e7-b665-aaf76a94bd59",
    "StateWHRecords": [
        {
            "SequenceId": "001",
            "RecordId": "019df72a-5f7f-741b-8b80-50b7b9d32ea7",
            "ReturnHeader": {
                "Qtr": "Q1",
                "TaxYr": "2026",
                "Business": {
                    "BusinessNm": "Vertex Construction",
                    "TradeNm": "Vertex Builders",
                    "IsEIN": true,
                    "EINorSSN": "45-1254828",
                    "Email": "natalie.zimmerman@vertexconstruction.com",
                    "ContactNm": "Natalie Zimmerman",
                    "Phone": "8035551234",
                    "BusinessType": "PART",
                    "SigningAuthority": {
                        "Name": "Natalie Zimmerman",
                        "Phone": "8035559876",
                        "BusinessMemberType": "OWNER"
                    },
                    "IsForeign": false,
                    "USAddress": {
                        "Address1": "1500 Main Street",
                        "Address2": "Suite 200",
                        "City": "Columbia",
                        "State": "SC",
                        "ZipCd": "29201"
                    },
                    "ForeignAddress": {
                        "Address1": null,
                        "Address2": null,
                        "City": null,
                        "ProvinceOrStateNm": null,
                        "Country": null,
                        "PostalCd": null
                    }
                }
            },
            "ReturnData": {
                "FormFR900Q": {
                    "WHIdNum": "300516556165",
                    "IsBusinessClosed": true,
                    "LastPayrollDt": "02/20/2025",
                    "IsDiffMailAdd": true,
                    "MailAddress": {
                        "Address1": "210 Gervais Street",
                        "Address2": "Floor 3",
                        "City": "Columbia",
                        "State": "SC",
                        "ZipCd": "29204"
                    },
                    "TotTaxWH": 1500,
                    "IsMonthlyPayer": true,
                    "Month1TaxWH": 500,
                    "Month2TaxWH": 500,
                    "Month3TaxWH": 500,
                    "TotTaxDeposit": 2000,
                    "BalanceDue": 0,
                    "Overpayment": 500,
                    "OverPaymentRecoveryType": "APPLYTORETURN",
                    "IsThirdPartyDesignee": true,
                    "ThirdPartyDesignee": {
                        "Name": "Martin Bradley",
                        "Phone": "8037654321"
                    }
                }
            }
        }
    ]
}

Response JSON

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

{
  "StatusCode": "200",
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "019c9e34-399a-7769-b5f2-dcd8a731059e",
  "SuccessRecords": [
      {
          "SequenceId": "001",
          "BusinessId": "5bdac546-c0ab-4fd7-aac1-251883b4f316",
          "PayerRef": null,
          "RecordId": "019c9e34-83b0-7633-9bb7-b66ef7d90eae",
          "FormType": "FR900Q",
          "Status": "CREATED",
          "StatusTs": "2026-04-29 10:15:32 +05:30",
          "Info": null,
          "Errors": null
      }
  ],
  "ErrorRecords": null,
  "Errors": null
}

Unauthorized Response - You'll get the below response when your API requests don't contain valid authentication credentials.

{
  "StatusCode": 401,
  "StatusMessage": "Unauthorized",
  "StatusName": "Invalid authorization credentials",
  "Errors": [
      {
          "Id": "AUTH-100018",
          "Name": "Authorization",
          "Message": "JWT EXPIRED"
      }
  ]
}

W-9/W-8 Automation

1099 Automation

TIN Matching

W-2 Automation

941/940 Automation

1098-T Automation

ACA Automation

Extension Automation

1042-S Automation

Supported Forms

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Healthcare Market Research Platforms

Update

Update

Request Body

Response Body

Request JSON​

Response JSON​

Request JSON

Response JSON