Version: 1.7.3

Update

Updates the existing return created in TaxBandits. Use the unique identifiers to refer a particular return, employer, employee or covered individual. You can not update a Transmitted return..

PUT Form1095C/Update

Request Body

Field	Type	Description
SubmissionManiFest	object	SubmissionManiFest provides brief information about a particular submission on the whole. It contains information like Submission ID, Tax Year & Employee Count.
SubmissionId	Guid	Unique identifier created by TaxBandits for each submission. Not required when you are creating a return.
TaxYr	string	Tax year of the return. Refer static values. Allowed values: "2021", "2022", "2023"
IsFederalFiling	Boolean	This value must be set as True in order to have Form 1095C filed to the IRS.
IsPostal	Boolean	If this value is set as True, the postal mailing service will be opted for all the employees included in the submission. Once the returns are transmitted, the 1095C form copies will be mailed to the employee address via USPS. Note: Postal Orders for Foreign Address will not be created.
IsOnlineAccess	Boolean	If this value is set as True, the Online Access service will be enabled for all the employees included in the submission. Once the returns are transmitted, an email with a link to the secure TaxBandits portal will be sent to the employees. The employees can then provide consent and download Form 1095C copies from the portal. The Online Access portal can be customized with your logo.
ACAForms	object	Contains Information of the aca forms 1094C and 1095C.
ReturnHeader	object	Contains information that applies to the entire tax return.
Business	object	Object to identify the Business Details.
BusinessId	Guid	Use 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
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
Email	string	Email address of the Business Size Range: ..100
ContactNm	string	Optional 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 number of the business phone number. Size Range: ..5
Fax	string	Optional Fax number of the Business. Size Range: 10
BusinessType	string	Optional Type of business. Optional for W-2/1099 and mandatory for 94X series. Size Range: 4 Allowed values "ESTE", "PART", "CORP", "EORG", "SPRO" For the description of the Allowed Values , click here
SigningAuthority	object	Optional Details of the person who is authorized to sign the return
Name	string	Optional Name of the signing authority. Size Range: ..35
Phone	string	Optional Phone number of the authorized signatory. Size Range: 10
BusinessMemberType	string	Optional Business title of the authorized signatory. 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	Identifies the kind of payer. This field is mandatory in W-2 and optional in 1099-MISC and 94X series 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	Address of the Employer/Payer (street address or post office box of that locality) Size Range: ..46
Address2	string	Optional Suite or apartment number of the Employer/Payer. Size Range: ..46
City	string	City where the Employer/Payer is based out of. Size Range: ..50
State	string	Name of the state where the Employer/Payer is based out of. 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	Zip Code the State where the Employer/Payer is based out of. Size Range: 5..10
ForeignAddress	object	If IsForeign is true, pass foreign address of the business
Address1	string	Address of the Employer/Payer (street address or post office box of that locality). Size Range: ..50
Address2	string	Optional Suite or apartment number of the Employer/Payer. Size Range: ..50
City	string	City where the Employer/Payer is based out of. Size Range: ..50
ProvinceOrStateNm	string	Name of the province or state where the Employer/Payer is based out of. Size Range: ..50
Country	string	Country of the Employer/Payer. 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	Postal Code the State where the Employer/Payer is based out of. Size Range: ..16
ACADetails	object	Contains specific field information for 1095 forms
FirstName	string	First Name of the contact person. Size Range: 50
MiddleName	string	OptionalMiddle initials of the contact person. Size Range: 15
LastName	string	Last name of the contact person. Size Range: 50
Suffix	string	OptionalName suffix of the contact person. Refer static values. Size Range: 3 Allowed values "JR", "SR", "II", "III", "IV", "V", "VI", "VII"
Phone	object	Phone number of the government entity's contact person. Size Range: 10
IsGovernmentalUnit	boolean	When true, identifies that the business is a part of or related to the Governmental Unit
Form1094C	object	Contains Form 1094-C information.
Form1095CAttachedCnt	number	Number of 1095-C forms filed with this return. Refer to static values. Size Range: 3 Allowed values: "1-250"
AuthoritativeTransmittalInd	boolean	When true, identifies that out of other transmissions this is the Authoritative Transmittal for this year.
TotalForm1095CALEMemberCnt	number	Total number of Form 1095-C filed previously or will be filed on behalf of employer.Required only when AuthoritativeTransmittalInd is true. Refer static values. Size Range: 3 Allowed values: "1-250"
QualifyingOfferMethodInd	boolean	When true, identifies that the organization is eligible to use the Qualifying Offer method.
NinetyEightPctOfferMethodInd	boolean	When true, identifies that the organization is eligible to use the 98% Offer Method.
AggregateGroupMemberInd	boolean	When true, identifies that the employer was a member of an aggregated ALE group for any month of the calendar year.
AggregateGroupInformation	object[]	Collection of Aggregate Group Members Form 1094-C Part IV. Specify at least one business when AggregateGroupMemberInd is true.
BusinessNm	string	Business Name of aggregated ALE group member. Size Range: 75
BusinessNmCont	string	Optional If the business name is more than 75 characters, enter the remaining name here. Size Range: 75
MemberEIN	string	EIN of the aggregated ALE group member. Size Range: 9-11
ALEMemberInformation	object	Contains information of the ALE member.
AllTwelveMonthsInd	boolean	When true, indicates that minimum essential coverage is applicable for the entire year.
TwelveMonths	object	Required if AllTwelveMonthsInd is true. Contains information of Form 1094-C Part III, Line 23.
IndividualMonth	string	The individual months for which coverage was offered to the covered individuals. Refer static values. Allowed values: "1-12"
Month	string	Month for which minimum essential coverage is applicable. Refer static values. Allowed values: "1-12"
MinEssentialCvrOffrCd	boolean	When true, identifies that the employer offered minimum essential coverage to its full-time employees and their dependents.
ALEMemberFTECnt	number	The number of Section 4980H full-time employees for each month.
TotalEmployeeCnt	number	The total number of employees including full-time employees and part time employees and employees in a limited non-assessment period, for each calendar month.
AggregateGroupInd	boolean	When true, identifies that the employer was a member of an aggregated ALE group.
IndividualMonth	object[]	Required if AllTwelveMonthsInd is false. Contains information of Form 1094-C Part III, Line 24 to Line 35
Month	string	Month code of respective months. Refer static values. Allowed values: "1-12"
MinEssentialCvrOffrCd	boolean	MEC indicator.
ALEMemberFTECnt	number	ALE member full time equivalent count.
TotalEmployeeCnt	number	The total number of employees including full-time employees and part time employees and employees in a limited Non- assessment period, for each calendar month.
AggregateGroupInd	boolean	When true, identifies that the employer was a member of an aggregated ALE group.
DesignatedGovernmentEntityDetails	object	Contains information of the Designated Government Entity. Required when IsGovernmentalUnit is true.
Name	string	Name of the designated government entity. Size Range: 75
NameCont	string	Optional Name continuation of the designated government entity. Size Range: 75
EIN	string	EIN of the designated government entity. Size Range: 10
IsForeign	boolean	When true, identifies that the designated government entity's address as a foreign address.
USAddress	object	Contains US address information of the government entity.
Address1	string	Contains US address information of the Government Entity. Required only when IsForeign is false. Size Range: 46
Address2	string	Optional government entity suite or apartment. Size Range: 46
City	string	government entity city. Size Range: 50
State	string	Government Entity state code. Refer static values. 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	Filer/Employer/government entity zip code. Size Range: 5..10
ForeignAddress	object	if IsForeign is true, pass foreign address of the Filer.
Address1	string	Government entity foreign address(street address or post office box of that locality). Size Range: 50
Address2	string	Optional Government entity suite or apartment. Size Range: 50
City	string	Government entity foreign city. Size Range: 50
ProvinceOrStateNm	string	Government entity foreign province or state name. Size Range: 50
Country	string	Government Entity Foreign Country. Refer static values. 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	Government entity foreign postal code. Size Range: 16
ContactInfo	object	Contains person information of the government entity.
FirstNm	string	First Name of the government entity's contact person. Size Range: 50
MiddleNm	string	Optional Middle initials of the government entity's contact person. Size Range: 15
LastNm	string	Last name of the government entity's contact person. Size Range: 50
Suffix	string	Optional Name suffix of the government entity's contact person. Refer static values. Size Range: 3 Allowed values "JR", "SR", "II", "III", "IV", "V", "VI", "VII"
Phone	string	Phone number of the government entity's contact person. Size Range: 10
ReturnData	object	Contains 1095-C return information. Collection of multiple 1095-Cs.
RecordId	Guid	Record Id of the particular record.
Form1095C	object[]	Contains collection of 1095-C returns information.
EmployeeManifest	object	Contains 1095C Id and sequence number of the 1095-C return.
Form1095CId	Guid	Unique id to identify each Form 1095 C.
Form1095SeqNum	string	Sequence number.
Employee	object	Object to identify the employee details.
EmployeeId	Guid	An unique ID generated by TaxBandits after the return is created and will be returned in the Response. You can use this id for your future reference to Update.
SSN	string	Employee's Social Security Number (SSN) Size Range: 9-11
FirstNm	string	Employee's first name. Size Range: 15
MiddleNm	string	Optional Employee's middle name. Size Range: 15
LastNm	string	Employee's last name. Size Range: 20
Suffix	string	Optional Employee's suffix. Allowed values "JR", "SR", "I", "II", "III", "IV", "V", "VI", "VII"
Email	string	Optional Employee's email address. Size Range: 0..40
Fax	string	Optional Employee's fax number. Size Range: 10
Phone	string	Optional Employee's phone number Size Range: 10
IsForeign	Boolean	When true, identifies the employee address with a foreign address.
USAddress	object	Object to identify the employee's US address
Address1	string	Employee's US address (street address or post office box of that locality) Size Range: ..46
Address2	string	Employee's suite or apartment Size Range: ..46
City	string	Employee's city Size Range: ..50
State	string	Employee's State code. Refer Static values. 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	Employee's zip code Size Range: 5..10
ForeignAddress	object	If IsForeign is true, pass foreign address of the employee
Address1	string	Employee's foreign address (street address or post office box of that locality) Size Range: ..50
Address2	string	Optional Employee's suite or apartment Size Range: ..50
City	string	Employee's city. Size Range: ..50
ProvinceOrStateNm	string	Employee's Province or State Name. Size Range: ..50
Country	string	Employee's country code. Refer Static values. 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	Employee's Postal Code. Size Range: ..16
EmployeeReturnDetails	object	Contains 1095-C Part I, Part II and Part III return information.
EmployeeAgeOnJan1	int	Employee's age on Jan 1, 2023.
StartMonthNumberCd	string	Calendar month in which the health plan begins and the employee is offered coverage for the tax year. Refer static values. Allowed values: "00-12"
AllTwelveMonthsInd	Boolean	When true indicates that the health plan is active for all 12 months and you do not have to specify health plan for each month separately.
TwelveMonths	object	Contains information of the Offer of Coverage, Employee Contribution, Section 4980 H codes for the month Jan to Dec. Required only when AllTwelveMonthsInd is TRUE.
OfferOfCoverage	string	The coverage plan provided to the employee. Refer static values. Allowed values "1A", "1B", "1C", "1D", "1E", "1F", "1H","1I","1J","1K","1L","1M","1N","1O" ,"1P","1Q","1R","1S","1T","1U"
EmployeeRequiredContribution	string	The employee share of the lowest cost monthly premium for self-only minimum essential coverage(MEC) providing minimum value(MV) offered to the employee. Size Range: 9
Section4980H	string	The applicable Code Series 2 indicator code that has to be reported for one or more months of the calendar year, if any. Refer static values. Allowed values "2A", "2B", "2C", "2D", "2E", "2F", "2G", "2H"
ZipCd	string	Enter the ZIP code of the employee’s residence for (code 1L, 1M, or 1N) or the ZIP code of the employee’s primary site of employment if the ALE Member uses the work location safe harbor for (code 1O, 1P, or 1Q).
IndividualMonth	object[]	Contains information of the Offer of Coverage, Employee Contribution, Section 4980 H codes for the month Jan to Dec. Required only when AllTwelveMonthsInd is false.
Month	string	Calendar month in which the health plan begins and the employee is offered coverage for the tax year. Allowed values: 1-12
OfferOfCoverage	string	The coverage plan provided to the employee. Refer static values. Allowed values "1A", "1B", "1C", "1D", "1E", "1F", "1H" ,"1I","1J","1K","1L","1M","1N","1O" ,"1P","1Q","1R","1S","1T","1U"
EmployeeRequiredContribution	string	The employee share of the lowest cost monthly premium for self-only minimum essential coverage(MEC) providing minimum value(MV) offered to the employee. Size Range: 9
Section4980H	string	The applicable Code Series 2 indicator code that has to be reported for one or more months of the calendar year, if any. Refer static values. Allowed values "2A", "2B", "2C", "2D", "2E", "2F", "2G", "2H"
ZipCd	string	Enter the ZIP code of the employee’s residence for (code 1L, 1M, or 1N) or the ZIP code of the employee’s primary site of employment if the ALE Member uses the work location safe harbor for (code 1O, 1P, or 1Q).
IsSelfInsured	Boolean	When true indicates that the employer has provided self-insured coverage for the individual.
UpdateCoveredIndividuals	object[]	Contains collection of each individual enrolled in coverage, including the employee. Required only when "IsSelfInsured" is true. Allowed values: 1-12
CoveredIndividualId	Guid	Unique ID generated by TaxBandits for the covered individual.
PersonFirstNm	string	First name of the covered individual. Size Range: 20
PersonMiddleNm	string	Optional Middle name of the covered individual Size Range: 20
PersonLastNm	string	Last name of the covered individual. Size Range: 20
SSN	string	SSN of the covered individual. Size Range: 9-11
DOB	string	Optional DOB of the covered individual.If SSN is not available for the covered individual. Size Range: MM/DD/YYYY
MonthsCoverageOffered	object	Contains coverage offer months from jan to dec.
AllTwelveMonths	boolean	When true indicates that coverage was offered for all 12 months for the covered individual.
IndividualMonth	string	The individual months for which coverage was offered to the covered individuals. Refer static values. Allowed values: "1-12"
DeleteCoveredIndividuals	object[]	Contains collection of CoveredIndividualIds to delete information of each individual enrolled in coverage, including the employee.
CoveredIndividualId	Guid	Unique ID generated by TaxBandits for the covered individual to delete.
DeleteForm1095C	object[]	Contains collection of Form1095CIds to delete 1095-C returns information.
Form1095CId	Guid	Unique id to delete each Form 1095 C.

Request JSON

{
    "SubmissionManiFest": {
    "SubmissionId": "c9fa349c-05aa-48c2-9e2d-de36c764e814",
    "TaxYr": "2023",
    "IsFederalFiling": true,
    "IsPostal": true,
    "IsOnlineAccess": true
    },
    "ACAForms": {
        "ReturnHeader": {
            "Business": {
               "BusinessId": "e8ac236c-52b0-4499-b850-3622f2c4922b",
                "BusinessNm": "LV LLC",
                "TradeNm": null,
                "IsEIN": true,
                "EINorSSN": "03-7534275",
                "Email": "sample@bodeem.com",
                "ContactNm": "John",
                "Phone": "9834567890",
                "PhoneExtn": "12345",
                "Fax": "9634567890",
                "BusinessType": "ESTE",
                "SigningAuthority": {
                    "Name": "John",
                    "Phone": "9934567890",
                    "BusinessMemberType": "ADMINISTRATOR"
                },
                "KindOfEmployer": "FederalGovt",
                "KindOfPayer": "REGULAR941",
                "IsBusinessTerminated": true,
                "IsForeign": false,
                "USAddress": {
                    "Address1": "1902 Kinsey Road",
                    "Address2": "Main St",
                    "City": "Dothan",
                    "State": "AL",
                    "ZipCd": "36303"
                },
                "ForeignAddress": {
                    "Address1": "500 Penn Avenue",
                    "Address2": "Park Street",
                    "City": "Toronto",
                    "ProvinceOrStateNm": "Ontario",
                    "Country": "CA",
                    "PostalCd": "02452"
                },
                "ACADetails": {
                    "FirstName": "Aafdir",
                    "MiddleName": "Walman",
                    "LastName": "Minster",
                    "Suffix": "jr",
                    "Phone": "8834578906",
                    "IsGovernmentalUnit": true
                }
            },
            "Form1094C": {
                "Form1095CAttachedCnt": 3,
                "AuthoritativeTransmittalInd": false,
                "TotalForm1095CALEMemberCnt": 0,
                "QualifyingOfferMethodInd": false,
                "NinetyEightPctOfferMethodInd": false,
                "AggregateGroupMemberInd": false,
                "AggregateGroupInformation":null,
                "ALEMemberInformation": {
                    "AllTwelveMonthsInd": false,
                    "TwelveMonths": null,
                    "IndividualMonth": null
                },
                "DesignatedGovernmentEntityDetails":  {
                    "Name": "Michal",
                    "NameCont": "jack",
                    "EIN": "25-8789173",
                    "IsForeign": false,
                    "USAddress": {
                        "Address1": "0219 Rain Road",
                        "Address2": "Main St",
                        "City": "Dothan",
                        "State": "AL",
                        "ZipCd": "36303"
                    },
                    "ForeignAddress": null,
                    "ContactInfo": {
                        "FirstNm": "Jack",
                        "MiddleNm": "Daniel",
                        "LastNm": "son",
                        "Suffix": "JR",
                        "Phone": "9889873456"
                    }
                }
            }
        },
        "ReturnData": {
            "RecordId": "b7f59c5e-256a-441f-bd12-8fef0523d61e",
            "AddForm1095C": [
                {
                    "EmployeeManifest": {
                        "Form1095CId": null,
                        "Form1095SeqNum": "4"
                    },
                    "Employee": {
                        "EmployeeId": null,
                        "SSN": "112-23-3451",
                        "FirstNm": "Steve",
                        "MiddleNm": "Michal",
                        "LastNm": "Waugh",
                        "Suffix": "Sr",
                        "Email": "sample@bodeem.com",
                        "Fax": "4567891234",
                        "Phone": "4259631478",
                        "IsForeign": false,
                        "USAddress": {
                            "Address1": "1751 Kinsey Rd",
                            "Address2": "Main St",
                            "City": "Dothan",
                            "State": "AL",
                            "ZipCd": "36303"
                        },
                        "ForeignAddress": null
                    },
                    "EmployeeReturnDetails": {
                        "EmployeeAgeOnJan1": "26",
                        "StartMonthNumberCd": "06",
                        "AllTwelveMonthsInd": true,
                        "TwelveMonths": {
                            "Month": null,
                            "OfferOfCoverage": "1S",
                            "EmployeeRequiredContribution": 0,
                            "Section4980H": "2D",
                            "ZipCd": "57879"
                        },
                        "IndividualMonth": null,
                        "IsSelfInsured": true,
                        "CoveredIndividuals": [
                            {
                                "CoveredIndividualId": null,
                                "PersonFirstNm": "Steve",
                                "PersonMiddleNm": "Michal",
                                "PersonLastNm": "Waugh",
                                "SSN": "112-23-3451",
                                "DOB": null,
                                "MonthsCoverageOffered": {
                                    "AllTwelveMonths": true,
                                    "IndividualMonths": null
                                }
                            }
                        ]
                    }
                }
            ],
            "UpdateForm1095C": [
                {
                    "EmployeeManifest": {
                        "Form1095CId": "f3300f74-440d-4289-a937-20152a6df4f7",
                        "Form1095SeqNum": "1"
                    },
                    "Employee": {
                        "EmployeeId": "c3e39508-a7d3-4fb7-b3a9-163059449658",
                        "SSN": "112-23-3451",
                        "FirstNm": "Steve",
                        "MiddleNm": "Michal",
                        "LastNm": "Waugh",
                        "Suffix": "Sr",
                        "Email": "sample@bodeem.com",
                        "Fax": "4567891234",
                        "Phone": "4259631478",
                        "IsForeign": false,
                        "USAddress": {
                            "Address1": "1751 Kinsey Rd",
                            "Address2": "Main St",
                            "City": "Dothan",
                            "State": "AL",
                            "ZipCd": "36303"
                        },
                        "ForeignAddress":null
                    },
                    "EmployeeReturnDetails": {
                        "EmployeeAgeOnJan1": "26",
                        "StartMonthNumberCd": "06",
                        "AllTwelveMonthsInd": true,
                        "TwelveMonths": {
                            "Month": null,
                            "OfferOfCoverage": "1G",
                            "EmployeeRequiredContribution": 0,
                            "Section4980H": "2D",
                            "ZipCd": "57879"
                        },
                        "IndividualMonth": null,
                        "IsSelfInsured": false,
                        "UpdateCoveredIndividuals": null
                    }
                }
            ],
            "DeleteForm1095C": [
                {
                    "Form1095CId": "b399fbea-e7d9-4564-adb2-b7df1d62613c"
                }
            ]
        }
    }
}

Response Body

Field	Type	Description
StatusCode	number	Returns the HTTP status codes like 200,300 etc.
StatusName	string	Name of the status code.
StatusMessage	string	Detailed status message.
SubmissionId	Guid	Unique identifier of a submission.
FormACARecords	object	Pulls the Form ACA 1095C&1094C records with Success and Error statuses
SuccessRecords	object	It will show the detailed information about the success status of Form ACA 1095C&1094C Records.
RecordId	Guid	Record Id of the particular record.
BusinessId	Guid	Unique Identifier of the business.
Form1095CRecords	object[]	contains success records of Form 1095C returns
Form1095SeqNum	string	This identifies the sequence on the record sent in the payload.When errors occur we will send the errors attached to particular sequence.Required
Form1095CId	Guid	Unique id to identify each Form 1095 C.
EmployeeId	Guid	An unique identifier generated by TaxBandits for a employee when a W2 return is created. You can use this id for your future reference to Update.
CoveredIndividualRecords	object[]	Contains Covered Individual records.
CoveredIndividualId	string	Unique ID generated by TaxBandits for the covered individual.
RecordStatus	string	Returns the status of the covered individual records.
StatusTS	string	Return updated date and time.
FederalReturn	object	Returns the record status and StatusTs of federal return.
Status	string	Returns the record status.
StatusTs	string	Returns date and time of return created.
Info	string	Returns information about the Federal Filing service.
Errors	object[]	Shows error information of state returns of Form 1095C.
Id	string	Returns the validation error Id.
Name	string	Name of the validation error.
Message	string	Description of the validation error
Postal	object	Returns the status and StatusTs of postal mailing service for Form 1095C.
Status	string	Returns the status of postal order.
StatusTs	string	Returns the date and time of the postal order created.
Info	string	Returns the information about Postal mailing service.
OnlineAccess	object	Returns the Email address for whom the online access to be given and Status of online access.
Status	string	Returns status of online access for Form 1095C return.
Email	string	Email address for whom the online access to be given.
Info	string	Information about the online access service.
Deleted1095CRecords	object	Returns deleted 1095-C records
Form1095CId	string	Unique id to identify each Form 1095 C.
ErrorRecords	object[]	It will show the detailed information about the error status of Form ACA 1095C&1094C Records
Id	string	Returns the validation error code.
Name	string	Name of the validation error.
Message	string	Description of the validation error.

Response JSON

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

{
    "StatusCode": 200,
    "StatusName": "Ok",
    "StatusMessage": "Successful API call",
    "SubmissionId": "4e19c58c-255c-4705-92a2-6e1307aa74e8",
    "FormACARecords": {
        "SuccessRecords": {
            "RecordId": "a3e70913-aaa7-4ca0-b91a-214ee03dc88e",
            "BusinessId": "d67d8541-5496-4a8b-a86e-a19a0210d79e",
            "Form1095CRecords": [
                {
                    "Form1095SeqNum": "1",
                    "Form1095CId": "7b0bf6b2-6156-4fe7-a51d-2b11c46d8f9f",
                    "EmployeeId": "a8f62ea6-b246-4722-8e8a-061b87f78ffc",
                    "CoveredIndividualRecords": [
                        {
                            "CoveredIndividualId": "27a73ccf-3a54-4611-93a2-3710792b2300",
                            "RecordStatus": "ADDED",
                            "StatusTS": "2024-02-05 00:40:13 -05:00"
                        },
                        {
                            "CoveredIndividualId": "99e3db80-e292-4d99-b666-6b23da50ea23",
                            "RecordStatus": "ADDED",
                            "StatusTS": "2024-02-05 00:40:13 -05:00"
                        }
                    ],
                    "FederalReturn": {
                        "Status": "CREATED",
                        "StatusTs": "2022-08-23 01:45:52 -04:00",
                        "Info": null,
                        "Errors": null
                    },
                    "Postal": {
                        "Status": "CREATED",
                        "StatusTs": "2022-08-23 01:45:54 -04:00",
                        "Info": null
                    },
                    "OnlineAccess": {
                        "Status": "CREATED",
                        "Email": "sample@bodeem.com",
                        "Info": null
                    }
                },
                {
                    "Form1095SeqNum": "2",
                    "Form1095CId": "51c2a9b4-d53c-4db5-827a-ef43b7d848d0",
                    "EmployeeId": "96e03cc9-2234-48f2-abe0-21c18d940955",
                    "CoveredIndividualRecords": [
                        {
                            "CoveredIndividualId": "9a3cdadc-6a8a-4f5b-b183-4159250d4209",
                            "RecordStatus": "ADDED",
                            "StatusTS": "2024-02-05 00:40:13 -05:00"
                        },
                        {
                            "CoveredIndividualId": "946da385-fabe-45e4-ad46-25ce9f51f808",
                            "RecordStatus": "ADDED",
                            "StatusTS": "2024-02-05 00:40:13 -05:00"
                        }
                    ],
                    "FederalReturn": {
                        "Status": "CREATED",
                        "StatusTs": "2022-08-23 01:45:52 -04:00",
                        "Info": null,
                        "Errors": null
                    },
                    "Postal": {
                        "Status": "CREATED",
                        "StatusTs": "2022-08-23 01:45:54 -04:00",
                        "Info": null
                    },
                    "OnlineAccess": {
                        "Status": "CREATED",
                        "Email": "sample@bodeem.com",
                        "Info": null
                    }
                }
            ],
            "Deleted1095CRecords": null
        },
        "ErrorRecords": null
    }
}

W-9 Automation

BOI Automation New

TIN Matching

1099 Automation

941/940 Automation

W-2 Automation

ACA Automation

Supported Forms

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Supported Forms

Request Body

Request JSON

Response Body

Response JSON