Update

Update

This endpoint is used to update the information on existing 15397 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 'RecordId' of the return you want to update.

Note:

You cannot edit a return that is already transmitted.

PUT Form15397/Update

Run in Postman

Request Body

Field	Type	Description
SubmissionManifest	object	Contains information about the submission, such as the Submission ID, and tax year.
SubmissionId	Guid	Unique identifier generated by TaxBandits for each submission. Not required when creating a new return.
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 details specific to Form 15397.
Forms	object	Identifies the forms for which an extension to furnish recipient copies is requested.
Is1042S	boolean	If true, extension requested for Form 1042-S.
Is1095Bor1095C	boolean	If true, extension requested for Forms 1095-B or 1095-C.
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.
Is1099QA	boolean	If true, extension requested for Form 1099-QA.
IsW2	boolean	If true, extension requested for Form W-2.
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.
ReasonForExtn	string	Required. Explanation for requesting the extension Size Range: ..300 .
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	Must be true to indicate consent and authorization of the signature.
SignedFromIP	string	IP address of the signer submitting Form 15397.

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.
Form15397Status	string	The IRS status of the Form 15397 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": "2022"
  },
  "ReturnHeader": {
    "Business": {
      "BusinessId": null,
      "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": "FederalGovt",
      "KindOfPayer": "REGULAR941",
      "IsBusinessTerminated": true,
     
      "USAddress": {
        "Address1": "1751 Kinsey Rd",
        "Address2": "Main St",
        "City": "Dothan",
        "State": "AL",
        "ZipCd": "36303"
      }
    }
  },
  "Form15397Data": {
    "Forms": {
      "Is1042S": false,
      "Is1095Bor1095C": false,
      "Is1097": false,
      "Is1098": false,
      "IsOther1099s": false,
      "Is3921": false,
      "Is3922": false,
      "IsW2G": false,
      "Is1099NEC": false,
      "Is1099QA": false,
      "IsW2": false,
      "Is5498": false,
      "Is5498ESA": true,
      "Is5498QA": true,
      "Is5498SA": true
    },
    "ReasonForExtn": "The for is used to request extension for recipient copies",
    "SignatureDetails": {
      "SignatureNm": "Steven Miller",
      "SignatureTitle": "Manager",
      "IsConsent": true,
      "SignedFromIP": "139.265.52"
    }
  }
}

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",
    "Form15397Status": "ORDER_RECEIVED",
    "StatusTs": "2023-05-10 10:35:28 +00:00",
    "Errors": null
}