Skip to main content
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 
Run in Postman

Request Body

FieldTypeDescription
SubmissionManiFestobjectSubmissionManiFest provides brief information about a particular submission on the whole. It contains information like Submission ID, Tax Year & Employee Count.
    SubmissionIdGuidUnique identifier created by TaxBandits for each submission. Not required when you are creating a return.
    TaxYrstringTax year of the return. Refer static values.
Allowed values: "2021", "2022", "2023"
    IsFederalFilingBooleanThis value must be set as True in order to have Form 1095C filed to the IRS.
    IsPostalBooleanIf 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.
    IsOnlineAccessBooleanIf 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.
ACAFormsobjectContains Information of the aca forms 1094C and 1095C.
    ReturnHeaderobjectContains information that applies to the entire tax return.
        BusinessobjectObject to identify the Business Details.
            BusinessIdGuidUse 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.
            BusinessNmstringName of the business
Size Range: ..75
            TradeNmstringOptional Name under which the business operates
Size Range: ..75
            IsEINBooleanWhen true, identifies the business with an EIN.
            EINorSSNstringWhen IsEIN is true, use Employer Identification Number (EIN). When IsEIN is false, use Social Security Number (SSN).
Size Range: 9-11
            EmailstringEmail address of the Business
Size Range: ..100
            ContactNmstringOptional Name of the person who can be contacted by the IRS.
Size Range: ..27
            PhonestringContact number of the business with area code.
Size Range: 10
            PhoneExtnstringOptional Extension number of the business phone number.
Size Range: ..5
            FaxstringOptional Fax number of the Business.
Size Range: 10
            BusinessTypestringOptional 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
            SigningAuthorityobjectOptional Details of the person who is authorized to sign the return
                NamestringOptional Name of the signing authority.
Size Range: ..35
                PhonestringOptional Phone number of the authorized signatory.
Size Range: 10
                BusinessMemberTypestringOptional 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"

            KindOfEmployerstringIdentifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series
Allowed values

"FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY"

            KindOfPayerstringIdentifies 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"

            IsBusinessTerminatedBooleanWhen true, identifies the business as terminated.
            IsForeignBooleanWhen true, identifies the business address with a foreign address.
            USAddressobjectIf IsForeign is false, pass US address of the business
                Address1stringAddress of the Employer/Payer (street address or post office box of that locality)
Size Range: ..46
                Address2stringOptional Suite or apartment number of the Employer/Payer.
Size Range: ..46
                CitystringCity where the Employer/Payer is based out of.
Size Range: ..50
                StatestringName 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"

                ZipCdstringZip Code the State where the Employer/Payer is based out of.
Size Range: 5..10
            ForeignAddressobjectIf IsForeign is true, pass foreign address of the business
                Address1stringAddress of the Employer/Payer (street address or post office box of that locality).
Size Range: ..50
                Address2stringOptional Suite or apartment number of the Employer/Payer.
Size Range: ..50
                CitystringCity where the Employer/Payer is based out of.
Size Range: ..50
                ProvinceOrStateNmstringName of the province or state where the Employer/Payer is based out of.
Size Range: ..50
                CountrystringCountry 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"

                PostalCdstringPostal Code the State where the Employer/Payer is based out of.
Size Range: ..16
        ACADetailsobjectContains specific field information for 1095 forms
            FirstNamestringFirst Name of the contact person.
Size Range: 50
            MiddleNamestringOptionalMiddle initials of the contact person.
Size Range: 15
            LastNamestringLast name of the contact person.
Size Range: 50
            SuffixstringOptionalName suffix of the contact person. Refer static values.
Size Range: 3
Allowed values

"JR", "SR", "II", "III", "IV", "V", "VI", "VII"

            PhoneobjectPhone number of the government entity's contact person.
Size Range: 10
            IsGovernmentalUnitbooleanWhen true, identifies that the business is a part of or related to the Governmental Unit
        Form1094CobjectContains Form 1094-C information.
            Form1095CAttachedCntnumberNumber of 1095-C forms filed with this return. Refer to static values.
Size Range: 3
Allowed values: "1-250"
            AuthoritativeTransmittalIndbooleanWhen true, identifies that out of other transmissions this is the Authoritative Transmittal for this year.
            TotalForm1095CALEMemberCntnumberTotal 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"
            QualifyingOfferMethodIndbooleanWhen true, identifies that the organization is eligible to use the Qualifying Offer method.
            NinetyEightPctOfferMethodIndbooleanWhen true, identifies that the organization is eligible to use the 98% Offer Method.
            AggregateGroupMemberIndbooleanWhen true, identifies that the employer was a member of an aggregated ALE group for any month of the calendar year.
            AggregateGroupInformationobject[]Collection of Aggregate Group Members Form 1094-C Part IV. Specify at least one business when AggregateGroupMemberInd is true.
                BusinessNmstringBusiness Name of aggregated ALE group member.
Size Range: 75
                BusinessNmContstringOptional If the business name is more than 75 characters, enter the remaining name here.
Size Range: 75
                MemberEINstringEIN of the aggregated ALE group member.
Size Range: 9-11
            ALEMemberInformationobjectContains information of the ALE member.
                AllTwelveMonthsIndbooleanWhen true, indicates that minimum essential coverage is applicable for the entire year.
                TwelveMonthsobjectRequired if AllTwelveMonthsInd is true. Contains information of Form 1094-C Part III, Line 23.
                    IndividualMonthstringThe individual months for which coverage was offered to the covered individuals. Refer static values.
Allowed values: "1-12"
                    MonthstringMonth for which minimum essential coverage is applicable. Refer static values.
Allowed values: "1-12"
                    MinEssentialCvrOffrCdbooleanWhen true, identifies that the employer offered minimum essential coverage to its full-time employees and their dependents.
                    ALEMemberFTECntnumberThe number of Section 4980H full-time employees for each month.
                    TotalEmployeeCntnumberThe total number of employees including full-time employees and part time employees and employees in a limited non-assessment period, for each calendar month.
                    AggregateGroupIndbooleanWhen true, identifies that the employer was a member of an aggregated ALE group.
                IndividualMonthobject[]Required if AllTwelveMonthsInd is false. Contains information of Form 1094-C Part III, Line 24 to Line 35
                    MonthstringMonth code of respective months. Refer static values.
Allowed values: "1-12"
                    MinEssentialCvrOffrCdbooleanMEC indicator.
                    ALEMemberFTECntnumberALE member full time equivalent count.
                    TotalEmployeeCntnumberThe total number of employees including full-time employees and part time employees and employees in a limited Non- assessment period, for each calendar month.
                    AggregateGroupIndbooleanWhen true, identifies that the employer was a member of an aggregated ALE group.
            DesignatedGovernmentEntityDetailsobjectContains information of the Designated Government Entity. Required when IsGovernmentalUnit is true.
                NamestringName of the designated government entity.
Size Range: 75
                NameContstringOptional Name continuation of the designated government entity.
Size Range: 75
                EINstringEIN of the designated government entity.
Size Range: 10
                IsForeignbooleanWhen true, identifies that the designated government entity's address as a foreign address.
                USAddressobjectContains US address information of the government entity.
                    Address1stringContains US address information of the Government Entity. Required only when IsForeign is false.
Size Range: 46
                    Address2stringOptional government entity suite or apartment.
Size Range: 46
                    Citystringgovernment entity city.
Size Range: 50
                    StatestringGovernment 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"

                    ZipCdstringFiler/Employer/government entity zip code.
Size Range: 5..10
                ForeignAddressobjectif IsForeign is true, pass foreign address of the Filer.
                    Address1stringGovernment entity foreign address(street address or post office box of that locality).
Size Range: 50
                    Address2stringOptional Government entity suite or apartment.
Size Range: 50
                    CitystringGovernment entity foreign city.
Size Range: 50
                    ProvinceOrStateNmstringGovernment entity foreign province or state name.
Size Range: 50
                    CountrystringGovernment 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"

                    PostalCdstringGovernment entity foreign postal code.
Size Range: 16
                ContactInfoobjectContains person information of the government entity.
                    FirstNmstringFirst Name of the government entity's contact person.
Size Range: 50
                    MiddleNmstringOptional Middle initials of the government entity's contact person.
Size Range: 15
                    LastNmstringLast name of the government entity's contact person.
Size Range: 50
                    SuffixstringOptional 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"

                    PhonestringPhone number of the government entity's contact person.
Size Range: 10
    ReturnDataobjectContains 1095-C return information. Collection of multiple 1095-Cs.
        RecordIdGuidRecord Id of the particular record.
        Form1095Cobject[]Contains collection of 1095-C returns information.
            EmployeeManifestobjectContains 1095C Id and sequence number of the 1095-C return.
                Form1095CIdGuidUnique id to identify each Form 1095 C.
                Form1095SeqNumstringSequence number.
            EmployeeobjectObject to identify the employee details.
                EmployeeIdGuidAn 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.
                SSNstringEmployee's Social Security Number (SSN)
Size Range: 9-11
                FirstNmstringEmployee's first name.
Size Range: 15
                MiddleNmstringOptional Employee's middle name.
Size Range: 15
                LastNmstringEmployee's last name.
Size Range: 20
                SuffixstringOptional Employee's suffix.
Allowed values

"JR", "SR", "I", "II", "III", "IV", "V", "VI", "VII"

                EmailstringOptional Employee's email address.
Size Range: 0..40
                FaxstringOptional Employee's fax number.
Size Range: 10
                PhonestringOptional Employee's phone number
Size Range: 10
                IsForeignBooleanWhen true, identifies the employee address with a foreign address.
                USAddressobjectObject to identify the employee's US address
                    Address1stringEmployee's US address (street address or post office box of that locality)
Size Range: ..46
                    Address2stringEmployee's suite or apartment
Size Range: ..46
                    CitystringEmployee's city
Size Range: ..50
                    StatestringEmployee'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"

                    ZipCdstringEmployee's zip code
Size Range: 5..10
                ForeignAddressobjectIf IsForeign is true, pass foreign address of the employee
                    Address1stringEmployee's foreign address (street address or post office box of that locality)
Size Range: ..50
                    Address2stringOptional Employee's suite or apartment
Size Range: ..50
                    CitystringEmployee's city.
Size Range: ..50
                    ProvinceOrStateNmstringEmployee's Province or State Name.
Size Range: ..50
                    CountrystringEmployee'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"

                    PostalCdstringEmployee's Postal Code.
Size Range: ..16
            EmployeeReturnDetailsobjectContains 1095-C Part I, Part II and Part III return information.
                EmployeeAgeOnJan1intEmployee's age on Jan 1, 2023.
                StartMonthNumberCdstringCalendar month in which the health plan begins and the employee is offered coverage for the tax year. Refer static values.
Allowed values: "00-12"
                AllTwelveMonthsIndBooleanWhen 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.
                TwelveMonthsobjectContains information of the Offer of Coverage, Employee Contribution, Section 4980 H codes for the month Jan to Dec. Required only when AllTwelveMonthsInd is TRUE.
                    OfferOfCoveragestringThe 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"

                    EmployeeRequiredContributionstringThe 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
                    Section4980HstringThe 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"

                    ZipCdstringEnter 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).
                IndividualMonthobject[]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.
                    MonthstringCalendar month in which the health plan begins and the employee is offered coverage for the tax year.
Allowed values: 1-12
                    OfferOfCoveragestringThe 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"

                    EmployeeRequiredContributionstringThe 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
                    Section4980HstringThe 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"

                    ZipCdstringEnter 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).
                IsSelfInsuredBooleanWhen true indicates that the employer has provided self-insured coverage for the individual.
                UpdateCoveredIndividualsobject[]Contains collection of each individual enrolled in coverage, including the employee. Required only when "IsSelfInsured" is true.
Allowed values: 1-12
                    CoveredIndividualIdGuidUnique ID generated by TaxBandits for the covered individual.
                    PersonFirstNmstringFirst name of the covered individual.
Size Range: 20
                    PersonMiddleNmstringOptional Middle name of the covered individual
Size Range: 20
                    PersonLastNmstringLast name of the covered individual.
Size Range: 20
                    SSNstringSSN of the covered individual.
Size Range: 9-11
                    DOBstringOptional DOB of the covered individual.If SSN is not available for the covered individual.
Size Range: MM/DD/YYYY
                    MonthsCoverageOfferedobjectContains coverage offer months from jan to dec.
                        AllTwelveMonthsbooleanWhen true indicates that coverage was offered for all 12 months for the covered individual.
                        IndividualMonthstringThe individual months for which coverage was offered to the covered individuals. Refer static values.
Allowed values: "1-12"
                    DeleteCoveredIndividualsobject[]Contains collection of CoveredIndividualIds to delete information of each individual enrolled in coverage, including the employee.
                        CoveredIndividualIdGuidUnique ID generated by TaxBandits for the covered individual to delete.
                    DeleteForm1095Cobject[]Contains collection of Form1095CIds to delete 1095-C returns information.
                        Form1095CIdGuidUnique 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

FieldTypeDescription
StatusCodenumberReturns the HTTP status codes like 200,300 etc.
StatusNamestringName of the status code.
StatusMessagestringDetailed status message.
SubmissionIdGuidUnique identifier of a submission.
FormACARecordsobjectPulls the Form ACA 1095C&1094C records with Success and Error statuses
    SuccessRecordsobjectIt will show the detailed information about the success status of Form ACA 1095C&1094C Records.
        RecordIdGuidRecord Id of the particular record.
        BusinessIdGuidUnique Identifier of the business.
        Form1095CRecordsobject[]contains success records of Form 1095C returns
            Form1095SeqNumstringThis identifies the sequence on the record sent in the payload.When errors occur we will send the errors attached to particular sequence.Required
            Form1095CIdGuidUnique id to identify each Form 1095 C.
            EmployeeIdGuidAn 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.
            CoveredIndividualRecordsobject[]Contains Covered Individual records.
                CoveredIndividualIdstringUnique ID generated by TaxBandits for the covered individual.
                RecordStatusstringReturns the status of the covered individual records.
                StatusTSstringReturn updated date and time.
            FederalReturnobjectReturns the record status and StatusTs of federal return.
                StatusstringReturns the record status.
                StatusTsstringReturns date and time of return created.
                InfostringReturns information about the Federal Filing service.
                Errorsobject[]Shows error information of state returns of Form 1095C.
                  IdstringReturns the validation error Id.
                  NamestringName of the validation error.
                  MessagestringDescription of the validation error
            PostalobjectReturns the status and StatusTs of postal mailing service for Form 1095C.
                StatusstringReturns the status of postal order.
                StatusTsstringReturns the date and time of the postal order created.
                InfostringReturns the information about Postal mailing service.
            OnlineAccessobjectReturns the Email address for whom the online access to be given and Status of online access.
                StatusstringReturns status of online access for Form 1095C return.
                EmailstringEmail address for whom the online access to be given.
                InfostringInformation about the online access service.
            Deleted1095CRecordsobjectReturns deleted 1095-C records
                Form1095CIdstringUnique id to identify each Form 1095 C.
    ErrorRecordsobject[]It will show the detailed information about the error status of Form ACA 1095C&1094C Records
            IdstringReturns the validation error code.
            NamestringName of the validation error.
            MessagestringDescription 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
}
}