Create

Create

This endpoint can be used to create a new Form 7004. Your request JSON must include the business details, the type of business tax return you need an extension for, and other required form details. When the request is successful, you’ll receive a SubmissionId, which uniquely identifies that form.

POST Form7004/Create 

Request Body

Field	Type	Description
SubmissionManifest	object	Contains information about the submission, such as the SubmissionId and tax year.
TaxYear	string	Tax year for the automatic 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 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: ..46 .
Address2	string	Optional Suite, unit, or apartment Size Range: ..46 .
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 7004
ExtnFormCd	string	Form code of the return for which automatic business income or information return extension is requested Allowed values "01", "02", "03", "04", "05", "06", "07", "08", "09", "11", "12", "34", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "35", "36"
IsForeignOrg	Boolean	If true, identifies that the organization is a foreign corporation that does not have an office or place of business in the United States
IsConsolRtn	Boolean	If true, identifies that organization is a corporation and is the common parent of a group that intends to file a consolidated return
ConsolInfo	object	Contains information about name, address, and employer identification number (EIN) for each member of consolidated group
BusinessNm	string	Business name of the consolidated group Size Range: ..75
IsNoEIN	Boolean	If true, Identifies that business has no EIN
Reason	string	Reason for not obtained EIN Allowed values "NONE", "PENDING", "APPLIED_FOR"
EIN	string	EIN of the business Size Range: 9-10
IsForeign	Boolean	When true, identifies the business address with a foreign address.
USAddress	object	if IsForeign is false, pass US address of the business
Address1	string	Consolidated group member's US address (street address or post office box of that locality) Size Range: ..46
Address2	string	Optional Consolidated group member's suite or apartment Size Range: ..46
City	string	Consolidated group member's city Size Range: ..50
State	string	Consolidated group member's state 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	Consolidated group member's zip code. Size Range: 5..10
ForeignAddress	Object	if IsForeign is true, pass foreign address of the business
Address1	string	Consolidated group member's foreign address (street address or post office box of that locality). Size Range: ..50
Address2	string	Optional Consolidated group member's suite or apartment Size Range: ..50
City	string	Consolidated group member's city Size Range: ..50
ProvinceOrStateNm	string	Consolidated group member's province or state name Size Range: ..50
Country	string	Consolidated group member's country Size Range: 2
PostalCd	string	Consolidated group member's postal code Size Range: ..16
IsOrgQualExcep	Boolean	If true identifies that organization is a corporation or partnership that qualifies under Regulations section 1.6081-5
IsCalendarTaxYear	Boolean	If true identifies that organization uses a calendar tax year
FiscalTaxYearDetails	Object	Contains information about the fiscal tax year. (Required if organization uses a non-calendar tax year)
TaxYearBeginDate	string	Fiscal tax year beginning date. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY Example: 01/25/2025 or 01-25-2025
TaxYearEndDate	string	Fiscal tax year end date. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY Example: 01/25/2025 or 01-25-2025
IsShortTaxYear	Boolean	If true identifies that the organization is operating on a short tax year
ShortTaxYearReason	Object	Contains information about the short tax year reason
IsInitialRtn	Boolean	If true identifies that this is the initial return for your organization after receiving the EIN
IsFinalRtn	Boolean	If true identifies that this is the last return your organization will file because it has ceased operations
IsAccPeriodChange	Boolean	If true identifies that the organization’s accounting period has changed
IsConsoRtn	Boolean	If true identifies that the business is a corporation, common parent of a group, or agent of a consolidated group that intends to file a consolidated return
IsOther	Boolean	If true identifies that there is any other reason for the short tax year
OtherReason	string	Other reason for the short tax year
TentativeTax	Number	Estimated total tentative tax liability (whole dollars only) Size Range: ..10
TotalPayments	Number	Total amount of tax payments made and any applicable tax credits (whole dollars only) Size Range: ..10
BalanceDue	Number	Remaining tax amount the business owes to the IRS (whole dollars only) Size Range: ..10
IRSPaymentType	string	Payment options to pay tax dues to 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
SigningAuthDetails	Object	Identifies the signing authority details
FirstNm	string	First name of the signing authority Size Range: ..20
MiddleNm	string	Middle name of the signing authority Size Range: ..20
LastNm	string	Last name of the signing authority Size Range: ..20
Suffix	string	Suffix of the signing authority Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
Title	string	Business title of the signing authority
PIN	string	A 5 digit PIN (Should not contain all zeroes) used when communicating to the IRS
Email	string	Email address of the signing authority Size Range: ..100
Phone	string	Contact number of the signing authority Size Range: 10

Response Body

Field	Type	Description
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.
Form7004Status	string	The IRS status of the Form 7004 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": {
        "TaxYear": "2025"
    },
    "ReturnHeader": {
        "Business": {
            "BusinessId": null,
            "BusinessNm": "Snowdaze LLC",
            "FirstNm": null,
            "MiddleNm": null,
            "LastNm": null,
            "Suffix": null,
            "PayerRef": "Pe123",
            "TradeNm": "Kodak",
            "IsEIN": true,
            "EINorSSN": "62-7369245",
            "Email": "sample@bodeem.com",
            "ContactNm": "John",
            "Phone": "1234567890",
            "PhoneExtn": "12345",
            "Fax": "1234567890",
            "IsForeign": false,
            "USAddress": {
                "Address1": "1751 Kinsey Rd",
                "Address2": "Main St",
                "City": "Dothan",
                "State": "AL",
                "ZipCd": "36303"
            },
            "ForeignAddress": null
        }
    },
    "ReturnData": {
        "ExtnFormCd": "02",
        "IsForeignOrg": false,
        "IsConsolRtn": true,
        "ConsolInfo": [
            {
                "BusinessNm": "MarkLLC",
                "IsNoEIN": false,
                "Reason": null,
                "EIN": "526897545",
                "IsForeign": false,
                "USAddress": {
                    "Address1": "1751 Kinsey Rd",
                    "Address2": "Main St",
                    "City": "Dothan",
                    "State": "AL",
                    "ZipCd": "36303"
                },
                "ForeignAddress": null
            }
        ],
        "IsOrgQualExcep": false,
        "IsCalendarTaxYear": false,
        "FiscalTaxYearDetails": {
            "TaxYearBeginDate": null,
            "TaxYearEndDate": null,
            "IsShortTaxYear": false,
            "ShortTaxYearReason": {
                "IsInitialRtn": false,
                "IsFinalRtn": false,
                "IsAccPeriodChange": true,
                "IsConsoRtn": false,
                "IsOther": false,
                "OtherReason": null
            }
        },
        "TentativeTax": 5000,
        "TotalPayments": 2500,
        "BalanceDue": 2500,
        "IRSPaymentType": "EFW",
        "IRSPayment": {
            "BankRoutingNum": "789658985",
            "AccountType": "SAVING",
            "BankAccountNum": "45698745125",
            "Phone": "7458968569"
        },
        "SigningAuthDetails": {
            "FirstNm": "David",
            "MiddleNm": null,
            "LastNm": "Miller",
            "Suffix": null,
            "Title": "Manager",
            "PIN": "85965",
            "Email": "sample1@gmail.com",
            "Phone": "8569874535"
        }
    }
    }

Response JSON

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

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