Create
Use this method to create Form 941-X. Your request must include business details, form data, and the applicable signature type.
Key Instructions:
Follow the instructions below and ensure you provide the necessary information on your API request JSON.
Part I
Type of Error : ADJUSTED or CLAIM
Part II
If the Type of Error is ADJUSTED then any one of line 4a, 4b, 4c should be selected
If the Type of Error is CLAIM then any one of line 5a, 5b, 5c, 5d should be selected
Part III
- TotalCorrectionAmt object need to given as to be correction Amount
- OriginallyReportedOrPrevCorrection object need to be given as original Amount
- CorrectionReportedDifference object should be given as Difference between Total Corrected amount - Amount originally reported or as previously corrected
- TaxCorrection object should be given as CorrectionReportedDifference amt multiply with instructions
In the 'Return Data' of the request JSON, the fields for corrected, previously reported, and amount difference are represented as separate objects: TotalCorrectionAmt, OriginallyReportedOrPrevCorrection and CorrectionReportedDifference. You must provide the corresponding values in the appropriate fields for each.
Signature Type:
- If ONLINE_SIGN_PIN is chosen as the SignatureType, a 10-digit signature PIN issued by the IRS should be supplied here.
- If FORM_8453_EMP is chosen as the SignatureType, then call the method DownloadForm8453EMP, download the form, and send it to the taxpayer. Sign the 8453 EMP form and upload it back using UploadForm8453EMP.
- If REPORTING_AGENT is chosen as the SignatureType, enter the 5-digit PIN issued by the IRS.
- If ERO is chosen as the SignatureType, call the DownloadForm8879EMP endpoint to download the Form 8879 form, obtain the taxpayer signature and keep it for your records.
To find out which signature type applies to you, click here.
All the amount fields should be rounded to two decimal places. An error will occur if you enter more than two decimal places or the value is 0.000.
POST Form941X/Create
Request Body
Field | Type | Description |
---|---|---|
Form941XRecords | object[] | Object to create 941-Xs |
SequenceId | string | A unique number given by an inbound application to identify failed records. Size Range: ..10 |
ReturnHeader | object | Identifies the supporting details of Form 941. |
ReturnType | string | Type of the return to be filed. Enter values like FORM941, FORM941SS.Allowed values"FORM941", "FORM941SS" |
TaxYr | string | The Tax year for which Form 941 needs to be filed. Allowed values: "2024" |
Qtr | string | The Quarter for which Form 941 needs to be filed. Allowed values"Q1", "Q2", "Q3", "Q4" |
Business | object | Business Details |
BusinessId | Guid | OptionalUse the unique Business ID (Generated by TaxBandits), you received in the response of the Business CREATE Endpoint. If you do not have a Business ID, ignore the field. By giving the Business ID, you do not have to provide all the business information again. |
BusinessNm | string | Name of the business Size Range: ..75 |
PayerRef | string | Optional An unique identifier for each payer completing their information. This identifier can be used in future references of the payer in the API. Size Range: ..50 |
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 Employer Identification Number (EIN). When IsEIN is false, use Social Security Number (SSN). Size Range: 9-11 |
string | Email address of the Business Size Range: ..100 | |
ContactNm | string | Name of the person who can be contacted by the IRS Size Range: ..27 |
Phone | string | Contact number of the business with area code 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. Optional for W-2/1099 and mandatory for 94X series Size Range: ..4 Allowed values"ESTE", "PART", "CORP", "EORG", "SPRO" |
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 | Identifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series.Allowed values"FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY" |
KindOfPayer | string | Kind Of Payer based on the Employer's Federal Tax Return.Allowed values"REGULAR941", "REGULAR944", "AGRICULTURAL943", "HOUSEHOLD", "MILITARY", "MEDICAREQUALGOVEM", "RAILROADFORMCT1" |
IsBusinessTerminated | Boolean | When true, identifies the business as terminated. |
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 | Employer/Payer's US address (street address 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 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 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 |
IsThirdPartyDesignee | Boolean | When true, your third-party designee is allowed to discuss the return with the IRS. |
ThirdPartyDesignee | object | Third Party Designee Details |
Name | string | Third Party Designee's name. |
Phone | string | Third Party Designee's phone number |
PIN | string | A 5 digit PIN (Should not contain all zeroes) used when communicating to the IRS |
SignatureDetails | object | Identifies the signature type used in Form 941 |
SignatureType | string | Type of signature used to sign Form 941Allowed values"ONLINE_SIGN_PIN", "FORM_8453_EMP", "REPORTING_AGENT" ,"ERO" |
OnlineSignaturePIN | object | A 10-digit signature PIN to become an IRS authorized signer. |
PIN | string | Sign using a 10 digit PIN received from the IRS. Size Range: 10 |
ReportingAgentPIN | object | A 5-digit number assigned by the IRS |
PIN | string | Sign using a 5 digit PIN received from the IRS. Size Range: 5 |
TaxPayerPIN | object | Use this option if you have selected ERO under SignatureType.. |
PIN | string | Any 5-digit PIN given by the Taxpayer on Form 8879-EMP Part II "Taxpayer Declaration and Signature Authorization". Size Range: 5 |
Form8453EMP | object | An alternate option to sign the return using Form 8453 EMP when there is no PIN |
BusinessStatusDetails | object | Identifies the status of the Business |
IsBusinessClosed | Boolean | When true, identifies the business as terminated or stopped paying wages |
BusinessClosedDetails | object | Identifies the Record Keeper details and date on which the Business was closed |
Name | string | Name of the Record Keeper Size Range: ..75 |
FinalDateWagesPaid | DateTime | Final date on which the business last paid the wages |
IsForeign | Boolean | When true, identifies if the business has a foreign address. |
USAddress | object | if IsForeign is false, pass US address of the business |
Address1 | string | Employer/Payer's US address (street address 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 |