Update

Update

This endpoint is used to update the information on existing 8809 extension forms created in the TaxBandits API. You can edit the filer details, form types, or any other fields in the form.

The request JSON must include the ‘SubmissionId’ and the ‘BusinessId‘ of the return you want to update.

Note:

You cannot edit a return that is already transmitted.

PUT Form8809/Update 

Run in Postman

Request Body

Field	Type	Description
SubmissionManifest	object	Contains information about the submission, such as the SubmissionId and tax year.
SubmissionId	Guid	Unique identifier of the submission, generated by TaxBandits.
TaxYear	string	Tax year for the extension request. Allowed values "2025"
ReturnHeader	object	Contains the business information for the filer.
Business	object	Business entity requesting the extension.
BusinessId	Guid	Optional Unique Business ID returned by the Business CREATE endpoint. If provided, business details do not need to be entered again.
BusinessNm	string	Legal name of the business Size Range: ..75
PayerRef	string	Optional Unique identifier assigned to the payer for reference in future API requests Size Range: ..50
TradeNm	string	Optional Trade name or “doing business as” (DBA) name of the business Size Range: ..75
IsEIN	Boolean	Indicates whether the business is identified by an EIN.
EINorSSN	string	Enter the EIN if IsEIN = true; otherwise, enter the SSN. Size Range: 9-11
Email	string	Contact email address for the business Size Range: ..100
ContactNm	string	Name of the contact person authorized to respond to IRS inquiries Size Range: ..27
Phone	string	Business phone number Size Range: 10
PhoneExtn	string	Optional Extension for the business phone number Size Range: ..5
Fax	string	Optional Fax number for the business Size Range: 10
BusinessType	string	Optional Indicates the type of business. 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"
BusinessMemberType	string	Optional Title of the signing authority Size Range: 5-29 Examples: "PRESIDENT", "TREASURER", "TRUSTEE", "OWNER", "CEO".
KindOfEmployer	string	Optional Identifies the type of employer. Allowed values "FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY"
KindOfPayer	string	Optional Identifies the type of payer. Allowed values "REGULAR941", "REGULAR944", "AGRICULTURAL943", "HOUSEHOLD", "MILITARY", "MEDICAREQUALGOVEM", "RAILROADFORMCT1"
IsBusinessTerminated	boolean	Indicates whether the business has been terminated.
USAddress	object	Business address in the United States.
Address1	string	Street address or P.O. Box Size Range: ..46
Address2	string	Optional Suite, unit, or apartment Size Range: ..46
City	string	City name Size Range: ..50
State	string	Two-letter state code.  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	ZIP code Size Range: 5–10
ReturnData	object	Contains information about Form 8809
Forms	object	Identifies the forms for which an extension to furnish recipient copies is requested.
IsW2	boolean	If true, extension requested for Form W-2.
IsOther1099s	boolean	If true, extension requested for any of the following forms: 1097, 1098, 1099-A, 1099-B, 1099-C, 1099-CAP, 1099-DIV, 1099-G, 1099-INT, 1099-K, 1099-LTC, 1099-LS, 1099-MISC, 1099-OID, 1099-PATR, 1099-Q, 1099-R, 1099-S, 1099-SA, 1099-SB, 3921, 3922, 1097-BTC, 1098-C, 1098-E, 1098-F, 1098-T, 1098-Q, and W-2G.
Is1099NEC	boolean	If true, extension requested for Form 1099-NEC.
Is1042S	boolean	If true, extension requested for Form 1042-S.
Is5498	boolean	If true, extension requested for Form 5498.
Is5498ESA	boolean	If true, extension requested for Form 5498-ESA.
Is5498QA	boolean	If true, extension requested for Form 5498-QA.
Is5498SA	boolean	If true, extension requested for Form 5498-SA.
Is8027	boolean	If true, extension requested for Form 8027.
Is1094or1095C	boolean	If true, extension requested for Form 1094-C or 1095-C.
Is1095B	boolean	If true, extension requested for Form 1095-B.
Is1099QA	boolean	If true, an extension is requested for Form 1099-QA.
ReasonForExtn	Object	Reason for requesting an extension. Size Range: ..300
IsCatastrophicEvent	boolean	If true, indicates that an extension is requested due to a catastrophic event in a federally declared disaster area, which either prevented the payer from resuming operations or made the necessary records unavailable.
IsNaturalDisaster	boolean	If true, indicates that an extension is requested due to a Fire, casualty, or natural disaster affecting the operation of the payer
IsDeathOrIllness	boolean	If true, indicates that an extension is requested due to Death, serious illness, or the unavoidable absence of the individual responsible for filing the information returns, which has affected the operation of the payer
IsFirstYr	boolean	If true, indicates that an extension is requested as the payer was in the first year of establishment.
IsInsuffData	boolean	If true, indicates that an extension is requested as the payer did not receive data on a payee statement, such as Schedule K-1, Form 1042-S, or the statement of sick pay required under section 31.6051-3(a)(1) in time to prepare an accurate information return.
SignatureDetails	Object	Contains the signature information for the authorized signer.
SignatureNm	String	Name of the authorized signer Size Range: ..35
SignatureTitle	String	Title of the authorized signer Size Range: 2–29
IsConsent	Boolean	Indicates whether the signer has consented to provide signature details.
SignedFromIP	String	IP address of the signer submitting Form 8809.

Response Body

Field	Type	Description
StatusCode	number	HTTP status code returned by the API (e.g., 200, 300, 400).
StatusName	string	Name of the HTTP status
StatusMessage	string	Detailed message explaining the status of the request.
SubmissionId	Guid	Unique identifier of the submission, generated by TaxBandits.
BusinessId	Guid	Unique identifier of the business associated with the submission.
PayerRef	string	User-defined reference identifier for the payer linked to the submission.
Form8809Status	string	The IRS status of the Form 8809 submission.
StatusTs	string	Date and time (ISO 8601 format) when the status was last updated.
Errors	object[]	Array of error objects (if any) containing details of validation or processing errors.
Id	string	Error code for a specific validation issue.
Name	string	Name of the validation error.
Message	string	Description of the error.

Request JSON

{
    "SubmissionManifest": {
        "SubmissionId": "4c74d0ed-fdd3-40eb-964f-c6021a8a8123",
        "TaxYear": "2025"
    },
    "ReturnHeader": {
        "Business": {
            "BusinessId": "139da969-28e0-4b40-b435-17cd42e8e1d8",
            "BusinessNm": "Snowdaze LLC",
            "PayerRef": "Pe123",
            "TradeNm": "Kodak",
            "IsEIN": true,
            "EINorSSN": "62-7369245",
            "Email": "sample@bodeem.com",
            "ContactNm": "John",
            "Phone": "1234567890",
            "PhoneExtn": "12345",
            "Fax": "1234567890",
            "BusinessType": "ESTE",
            "KindOfEmployer": null,
            "KindOfPayer": null,
            "IsBusinessTerminated": false,
            "USAddress": {
                "Address1": "3576 AIRPORT WAY",
                "Address2": "UNIT 9",
                "City": "FAIRBANKS",
                "State": "AK",
                "ZipCd": "99709"
            }
        }
    },
    "ReturnData": {
        "Forms": {
            "IsW2": false,
            "IsOther1099s": false,
            "Is1099NEC": false,
            "Is1042S": false,
            "Is5498": false,
            "Is5498ESA": true,
            "Is5498QA": false,
            "Is5498SA": true,
            "Is8027": false,
            "Is1094or1095C": false,
            "Is1095B": false,
            "Is1099QA": false
        },
        "ReasonForExtn": {
            "IsCatastrophicEvent": true,
            "IsNaturalDisaster": true,
            "IsDeathOrIllness": true,
            "IsFirstYr": true,
            "IsInsuffData": true
        },
        "SignatureDetails": {
            "SignatureNm": "Steven Miller",
            "SignatureTitle": "Manager",
            "IsConsent": true,
            "SignedFromIP": "197.88.9.0"
        }
    }
}

Response JSON

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

{
    "StatusCode": 200,
    "StatusName": "Ok",
    "StatusMessage": "Successful API call",
    "SubmissionId": "4c74d0ed-fdd3-40eb-964f-c6021a8a8123",
    "BusinessId": "c09bda9e-083d-486d-8638-a2869c6df671",
    "PayerRef": "Pe123",
    "Form8809Status": "CREATED",
    "StatusTs": "2023-05-10 10:33:29 +00:00",
    "Errors": null
}