Update

Update

This endpoint allows you to update the details of an existing Form 4868. The request JSON must include the SubmissionId of the return you want to update.

Note:

Returns that have already been transmitted cannot be edited.

PUT Form4868/Update 

Request Body

Field	Type	Description
SubmissionManifest	object	Contains information about the submission, such as the SubmissionId and tax year.
SubmissionId	Guid	Unique identifier of a submission.
TaxYear	string	Tax year for the automatic extension request. Allowed values "2025"
ReturnHeader	object	Contains the business information for the filer.
TaxPayer	object	Taxpayer requesting the extension.
TaxPayerId	Guid	Optional Unique Business ID returned by the Business CREATE endpoint. If provided, taxpayer details do not need to be entered again.
FirstNm	string	First Name of Taxpayer
MiddleNm	string	Optional Middle Name of Taxpayer
LastNm	string	Last Name of Taxpayer
Suffix	string	Optional Suffix of the Taxpayer Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
IsEIN	Boolean	Indicates whether the business is identified by an EIN. Note: To file a Form 4868 return, the IsEIN must be set to false by default, since only the SSN TIN type is permitted for this form
EINorSSN	string	Enter the EIN if IsEIN = true; otherwise, enter the SSN. Size Range: 9-11
TaxTaxPayerRef	string	Optional Unique identifier assigned to the taxpayer 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
IsForeign	Boolean	When true, identifies if the taxpayer has a foreign address.
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
ForeignAddress	object	Business address outside of the United States.
Address1	string	Street address or P.O. Box Size Range: ..50
Address2	string	Optional Suite, unit, or apartment Size Range: ..50
City	string	City name (Max 50 characters).
ProvinceOrStateNm	string	Province or state name Size Range: ..50
Country	string	Two-letter country code 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	Postal code (Max 16 characters).
ReturnData	object	Contains information about Form 4868
TypeOfFiling	string	Type of individual requests for an automatic extension to file a U.S. individual income tax return Allowed values "SINGLE", "JOINT"
SpouseDetails	object	Identifies details of the spouse
FirstNm	string	First name of the spouse Size Range: ..20
MiddleNm	string	Middle name of the spouse Size Range: ..20
LastNm	string	Last name of the spouse Size Range: ..20
Suffix	string	Suffix of the spouse Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
SSN	string	Enter the SSN of the spouse Size Range: 9-11
Phone	string	Spouse phone number Size Range: 10
IsTaxPayerAbroad	Boolean	When true, it identifies that the taxpayer is “out of the country” and is a U.S. citizen or resident
IsNonResNoWH	Boolean	If true, it identifies that the taxpayer has filed Form 1040-NR and did not receive wages subject to U.S. income tax withholding.
TentativeTax	Number	Estimated total tentative tax liability (whole dollars only) Size Range: ..10
TotPayments	Number	Total amount of tax payments or tax credits made (whole dollars only) Size Range: ..10
BalanceDue	Number	Balance due that the taxpayer owes to the IRS (whole dollars only) Size Range: ..10
PaymentAmt	Number	The amount you are paying to the IRS Size Range: ..10
IRSPaymentType	string	Payment options to pay tax dues for this return Allowed values "EFW", "EFTPS"
IRSPayment	Object	Identifies the details of Electronic Funds Withdrawal (EFW) if paying the balance due, along with the return
BankRoutingNum	string	Bank Routing Number of EFW payment Size Range: 9
AccountType	string	Account Type of EFW payment Allowed values "CHECKING", "SAVING"
BankAccountNum	string	Bank Account Number of EFW payment Size Range: ..17
Phone	string	Phone of EFW payment Size Range: 10
TaxPayerSignatureDetails	object	Identifies the taxpayer's signature details
PIN	string	Taxpayer's 5-digit PIN assigned by the IRS
DOB	string	Taxpayer's Date of Birth Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY. Example: 01/25/2025 or 01-25-2025
PrevYrAdjGrossIncome	Number	Taxpayer’s adjusted gross income (AGI) from the previous tax year
PrevYrPIN	string	Taxpayer's previous year PIN (5-digit number assigned by the IRS)
SpouseSignatureDetails	object	Identifies tax payer's signature details
PIN	string	Spouse's 5-digit PIN assigned by the IRS
DOB	string	Spouse's Date of Birth Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY. Example: 01/25/2025 or 01-25-2025
PrevYrAdjGrossIncome	Number	Spouse’s adjusted gross income (AGI) from the previous tax year
PrevYrPIN	string	Spouse’s previous year PIN (5-digit number assigned by the IRS)

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier of the submission, generated by TaxBandits.
TaxPayerId	Guid	Unique identifier of the business associated with the submission.
TaxPayerRef	string	User-defined reference identifier for the payer linked to the submission.
Form4868Status	string	The IRS status of the Form 4868 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": {
    "TaxPayer": {
      "TaxPayerId": null,
      "FirstNm": "Davidson",
      "MiddleNm": null,
      "LastNm": "Peter",
      "Suffix": null,
      "TaxTaxPayerRef": "Payer123",
      "TradeNm": "Kodak",
      "IsEIN": false,
      "EINorSSN": "627369245",
      "IsForeign": false,
      "USAddress": {
        "Address1": "1751 Kinsey Rd",
        "Address2": "Main St",
        "City": "Dothan",
        "State": "AL",
        "ZipCd": "36303"
      },
      "ForeignAddress": null
    }
  },
  "ReturnData": {
    "TypeOfFiling": "JOINT",
    "SpouseDetails": {
      "FirstNm": "Davidson",
      "MiddleNm": null,
      "LastNm": "Peter",
      "Suffix": null,
      "SSN": "627369245",
      "Phone":"1231231231"
    },
    "IsTaxPayerAbroad": false,
    "IsNonResNoWH": false,
    "TentativeTax": 5000,
    "TotPayments": 2500,
    "BalanceDue": 2500,
    "PaymentAmt": 2000,
    "IRSPaymentType": "EFW",
    "IRSPayment": {
      "BankRoutingNum": "789658985",
      "AccountType": "SAVINGS",
      "BankAccountNum": "45698745125",
      "Phone": "7458968569"
    },
    "TaxPayerSignatureDetails": {
      "PIN": "53698",
      "DOB": "12/12/2004",
      "PrevYrAdjGrossIncome": 500,
      "PrevYrPIN": null
    },
    "SpouseSignatureDetails": {
      "PIN": "16598",
      "DOB": "12/02/2006",
      "PrevYrAdjGrossIncome": 500,
      "PrevYrPIN": null
    }
  }
}

Response JSON

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

{
    "SubmissionId": "4c74d0ed-fdd3-40eb-964f-c6021a8a8123",
    "TaxPayerId": "c09bda9e-083d-486d-8638-a2869c6df671",
    "TaxPayerRef": "Pe123",
    "Form4868Status": "CREATED",
    "StatusTs": "2023-05-10 10:33:29 +00:00",
    "Errors": null
}