Version: 2.0.0

Update

This endpoint can be used to update the details on an existing 1095-B return or to add additional returns under the same SubmissionId. Your request JSON must include the SubmissionId and RecordId of the return you want to modify.

Key points

You cannot update a return once it has been transmitted.
The Tax Year of a submission cannot be changed once created. All other fields can be updated.

POSTform1095b/update

Run in Postman

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 - Federal Filing - State Filing - Distribution Details
SubmissionId	GUID	Unique identifier created by TaxBandits for each submission. Not required when you are creating a return.
TaxYear	string	Tax year of Form 1095-B to be filed. Allowed values "2025", "2026"
ReturnHeader	object	Contains information about the Business details.
Business	object	Object to identify the Business Details.
BusinessId	Guid	Use the unique Business ID (Generated by TaxBandits) that 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.
PayerRef	string	Optional Your unique identifier for the payer. Can replace `BusinessId` in future requests. Size Range: 50
IsDefaultBusiness	Boolean	When set to TRUE, this business will be set as the default across requests that do not specify a business.
TINDetails	object	TIN information for the business.
Format	string	Specifies how the TIN is passed. Allowed values "PLAIN_TIN" - Pass TIN directly. "ENCRYPTED_TIN" - Pass encrypted TIN. "TOKENIZED_TIN" - Pass tokenized TIN.
TINType	string	Specify the TIN type of the business. Allowed values "EIN", "SSN", “QI-EIN”, “ITIN”, “WP-EIN”, “WT-EIN”, “NQI-EIN”, “IRSN”
TIN	string	The TIN value according to the Format selected.
IndividualNm	object	Required when `TINType` is `SSN`. Provide individual name fields instead of `BusinessNm`.
FirstNm	string	The first name of the individual. Size Range: 20
MiddleNm	string	Optional Middle name of the individual. Size Range: 20
LastNm	string	The last name of the individual. Size Range: 20
Suffix	string	Optional Suffix of the individual's name. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
BusinessNm	string	Legal name of the business. Required when `TINType` is `EIN`. Size Range: 75
NameCtrl	string	IRS name control of the business. Size Range: 3-4
DBADetails	object[]	Optional DBA (Doing Business As) information.
DBANm	string	Name of the DBA. Size Range: 75
DBARef	string	Unique identifier for the DBA. Size Range: 1-50
DBAId	Guid	TaxBandits-generated DBA identifier. Use the unique DBA ID (Generated by TaxBandits) that you received in the response of the Business/AddDBA Endpoint. If you do not have a DBA ID, ignore the field. By giving the DBA ID, you do not have to provide all the DBA information again.
IsDefaultDBA	Boolean	When TRUE, marks this DBA as the default.
Address	object[]	Address information of DBA.
Address1	string	Street address or PO Box. Size Range: 46
Address2	string	Optional Suite or apartment number. Size Range: 46
City	string	DBA's city. Size Range: 50
ProvinceOrStateNm	String	DBA's province or state name. Allowed values When the country code is US: "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", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" When the country code is CA: "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	string	ZIP code of the business. Size Range: 5-16
Country	String	2-character country code of the business. 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", “US”, "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"
ContactDetails	object[]	Details of the person the IRS can contact regarding the given business.
FirstNm	string	First name of the contact person. Size Range: 20
MiddleNm	string	Optional Middle name of the contact person. Size Range: 20
LastNm	string	Last name of the contact person. Size Range: 20
Suffix	string	Optional The suffix of the contact person. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
Phone	string	Optional Phone number of the contact person. Size Range: 10 digits
PhoneExtn	string	Optional Phone extension number. Size Range: 5
Email	string	Optional Email address of the contact person. Size Range: 100
Fax	string	Optional Fax number of the contact person. Size Range: 10
ACASpecific	object[]	Object to identify the ACA specific details.
IsInsurer	Boolean	If true, identifies that you are a health insurance provider
IsGovernmentalUnit	Boolean	If true, identifies that you are a government agency or governmental organization providing health coverage.
ReturnData	object[]	Contains information about the recipient details and Form 1095-B details.
SequenceId	string	Optional A unique reference ID for the return that can be used to identify a particular record. The Sequence ID will be returned in the Response for your reference. Size Range: 50
Recipient	object	Object to identify the recipient details.
RecipientId	Guid	A unique ID generated by TaxBandits after the recipient is created and will be returned in the Response. You can use this ID for your future reference to update.
PayeeRef	string	Optional Your unique identifier for the recipient. Can replace `RecipientId` in future requests. Size Range: 50
TINDetails	object	Recipient TIN information.
Format	string	Specifies how the TIN is passed. Allowed values "PLAIN_TIN" - Pass TIN directly. "TOKENIZED_TIN" - Pass tokenized TIN.
TINType	string	TIN type of the recipient. Allowed values "SSN", "NA"
TIN	string	The TIN value according to the Format selected.
IndividualNm	object	Required when `TINType` is `SSN`. Provide individual name fields instead of `BusinessNm`.
FirstNm	string	The first name of the individual. Size Range: 20
MiddleNm	string	Optional The middle name of the individual. Size Range: 20
LastNm	string	Last name of the individual. Size Range: 20
Suffix	string	Optional The suffix of the individual’s name. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
BusinessNm	string	Legal name of the recipient business. Required when TINType is EIN. Size Range: 75
NameCtrl	string	IRS name control of the recipient. Size Range: 3-4
DBADetails	Object	Optional DBA (Doing Business As) information.
DBAId	GUID	TaxBandits-generated DBA identifier. Use the unique DBA ID (Generated by TaxBandits) that you received in the response of the Recipient/AddDBA Endpoint. If you do not have a DBA ID, ignore the field. By giving the DBA ID, you do not have to provide all the DBA information again.
DBANm	String	Name of the DBA. Size Range: 75
DBARef	String	Your unique identifier for this DBA. 1-50 characters
Address	object[]	Address information of DBA
Address1	String	Street address or PO Box. Max 46 characters
Address2	String	Optional Suite or apartment number. Max 46 characters
City	String	DBA’s city. Max 50 characters
ProvinceOrState	String	DBA’s province or state name. When the country code is US : 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", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	String	DBA’s ZIP code. 5 - 16 characters
Country	String	DBA’s 2-character country code. Allowed values "US", "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AT", "AU", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DO", "DM", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RO", "RS", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TK", "TF", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"
DOB	String	Optional Date of Birth of the recipient. Format: MM/DD/YYYY
Address	Object	Primary address of the recipient.
Address1	String	Street address or PO Box of the recipient. Size Range: 46
Address2	String	Optional Suite or apartment number of the recipient. Size Range: 46
City	String	City of the recipient. Size Range: 50
ProvinceOrState	String	Province or state name of the recipient. When the country code is US : 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" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	String	ZIP code of the recipient. Size Range: 5 - 16
Country	String	2-character country code of the recipient. Allowed values The size range is set to 50 for all countries except the United States and Canada.
Email	string	Email address of the recipient. Size Range: 100 Note: Required if the DistributionType is either "ONLINE_ACCESS" or "POSTAL_AND_ONLINE"
Fax	string	Optional Fax number of the recipient. Size Range: 10
Phone	string	Optional Phone number of the recipient. Size Range: 10
PhoneExtn	string	Optional Phone extension number. Size Range: 10
ReturnData	object[]	Contains information about the recipient details and Form 1095-B details.
Form1095BData	object[]	Form 1095-B details for the recipient.
HealthCoverageCd	number	Code identifying Origin of the Health Coverage Allowed values "A","B","C","D","E","F","G"
EmployerSponsoredCoverageDetails	Object	Optional Object identifying Employer-Sponsored Coverage details
SponsorNm	String	Optional Name of the sponsor Size Range: 75
EIN	String	Optional Employer Identification Number of the Sponsor Size Range: 9-10
Address	Object	Address information of Sponsor
Address1	String	Street address or PO Box. of Sponsor Size Range: 46
Address2	String	Optional Suite or apartment number Size Range: 46
City	String	Sponsor's city. Size Range: 50
ProvinceOrState	String	Sponsor's province or state name. When the country code is US : 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" When the country code is CA: Allowed values “AB”, ”BC”, ”MB”, ”NB”, ”NL”, ”NT”, ”NS”, ”NU”, ”ON”, ”PE”, ”QC”, ”SK”, ”YT” Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	String	Sponsor's ZIP code. 5 - 16 characters
Country	String	Sponsor's 2-character 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"
CoveredIndividualDetails	Object []	Object identifying Covered Individual's details of the recipient
FirstNm	string	First name of the covered individual. Size Range: 20
MiddleNm	string	Optional Middle name of the covered individual. Size Range: 20
LastNm	string	Last name of the covered individual. Size Range: 20
Suffix	string	Optional Suffix of the covered individual. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
SSN	string	Optional Social Security Number of the covered individual Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
DOB	string	Optional Date of birth of the covered individual Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY Example: 01/25/2026 or 01-25-2026
IsCoverageAllMonths	Boolean	If true, indicates that the individual had coverage for all months of the tax year.
CoverageMonths	Object	Months of coverage of the tax year Allowed values "JAN", "FEB", "MAR", "APR", "MAY", "JUN", "JUL", "AUG", "SEP", "OCT", "NOV", "DEC"
Form1099HCData	Object	Massachusetts Form 1099-HC information for the covered individual. Note: Required only when StateFiling is set to true and the recipient's state is Massachusetts (MA).
SubscriberNum	Object	Subscriber number of the covered individual Size Range: 6-20
IsFullYearMinimumCreditCoverage	Boolean	If true, indicates that the covered individual had full-year minimum creditable coverage.
MinimumCreditCoverageMonths	Object	Months with minimum creditable coverage: Allowed values "JAN", "FEB", "MAR", "APR", "MAY", "JUN", "JUL", "AUG", "SEP", "OCT", "NOV", "DEC"
Form1099HCData	Object	Massachusetts Form 1099-HC information for the covered individual. Note: Required only when StateFiling is set to true and the recipient's state is Massachusetts (MA).
SubscriberNum	String	Subscriber number of the covered individual Size Range: 6-20
IsFullYearMinimumCreditCoverage	Boolean	If true, indicates that the covered individual had full-year minimum creditable coverage.
MinimumCreditCoverageMonths	Object	Months with minimum creditable coverage: Allowed values "JAN", "FEB", "MAR", "APR", "MAY", "JUN", "JUL", "AUG", "SEP", "OCT", "NOV", "DEC"

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier of a submission.
BusinessId	Guid	Unique identifier of the business generated by TaxBandits. Store this for use in all subsequent requests.
PayerRef	string	Your unique identifier for the payer, as provided in the request.
DBARef	string	Your unique identifier for the DBA.
DBAId	Guid	Unique identifier of the DBA generated by TaxBandits.
RecordId	Guid	An unique identifier generated by TaxBandits when a 1095-B return is created.
Form1095Type	string	Denotes the type of ACA form
Form1095BRecords	object	Pulls Form 1095-B records with Success and Error statuses
SuccessRecords	object[]	It will show the detailed information about the success status of Form 1095-B Records.
SequenceId	string	A unique reference ID for the return that can be used to identify a particular record.
RecipientId	Guid	A unique ID generated by TaxBandits after the recipient is created
PayeeRef	string	Your unique identifier for the recipient, as provided in the request.
DBARef	string	Unique identifier for the recipient's DBA.
DBAId	Guid	Unique identifier of the recipient's DBA generated by TaxBandits.
Form1095BId	Guid	Unique id to identify each Form 1095-B.
CoveredIndividualRecords	Object[]	Contains collection of each individual enrolled in coverage, including the employee. Required only when "IsSelfInsured" is true.
CoveredIndividualId	Guid	Unique ID generated by TaxBandits for the covered individual.
Federal	object	Returns the record status and StatusTs of the federal return.
Status	string	Status of the operation.
StatusCd	string	Predefined status code for the status
StatusTs	string	Date and time of the return created.
Info	string	Returns information about the Federal Filing service.
Errors	object[]	Validation error details.
Id	string	Validation error code.
Name	string	Name of the validation rule that failed.
Message	string	Clear description of what went wrong and how to fix it.
State	object	Returns a collection of status and StatusTs of the State returns.
StateCd	string	Returns the state code of the state for which the return is filed.
Status	string	Returns the record status of the state return.
StatusCd	string	Predefined status code for the status
StatusTs	string	Date and time of the return created.
Info	string	Returns the information about the return processed for the state.
Errors	object[]	Validation error details.
Id	string	Validation error code.
Name	string	Name of the validation rule that failed.
Message	string	Clear description of what went wrong and how to fix it.
Distribution	object[]	Returns information about the distribution.
DistributionType	string	Returns the distribution method used.
Postal	object[]	Returns information about postal mailing.
PostalType	string	Returns the postal service used.
Status	string	Returns the Postal status.
StatusCd	string	Predefined status code for the status
StatusTs	string	Date and time of the postal created.
Info	string	Returns the information about the postal order.
OnlineAccess	object	Returns information about Online access.
Status	string	Returns status of online access for Form 1095-B return.
Email	string	Email address for whom the online access to be given.
Info	string	Information about the online access service.
ErrorRecords	object	It will show the detailed information about the error status of Form 1095-B Records.
SequenceId	string	A unique reference ID for the return that can be used to identify a particular record.
RecordId	Guid	An unique identifier generated by TaxBandits when a 1095-B return is created.
Errors	Object[]	Validation error details.
Id	String	Validation error code.
Name	String	Name of the validation rule that failed.
Message	String	Clear description of what went wrong and how to fix it.
Errors	Object[]	Top-level request errors if the entire request cannot be processed.
Id	String	Validation error code.
Name	String	Name of the validation rule that failed.
Message	String	Clear description of what went wrong and how to fix it.

Payload

Request JSON

Sample	Description	Action
Sample 1	Business – EIN, Recipient – SSN (Individual)

Sample 1

{
  "SubmissionManifest": {
    "SubmissionId": "f561a414-c92f-4026-9c29-71cd1979bf72",
    "TaxYear": "2026",
    "IsFederal": true,
    "IsState": true,
    "IsDistribution": true,
    "DistributionDetails": {
      "DistributionType": "POSTAL_AND_ONLINE",
      "PostalType": "USPS_FIRST_CLASS"
    }
  },
  "ReturnHeader": {
    "Business": {
      "PayerRef": "HZN-10001",
      "BusinessId": null,
      "IsDefaultBusiness": true,
      "TINDetails": {
        "Format": "PLAIN_TIN",
        "TINType": "EIN",
        "TIN": "72-5564875"
      },
      "IndividualNm": null,
      "BusinessNm": "Horizon LLC",
      "NameCtrl": "HORI",
      "DBADetails": null,
      "Address": {
        "Address1": "2500 Horizon Parkway",
        "Address2": "Suite 200",
        "City": "Plano",
        "ProvinceOrState": "TX",
        "ZipCd": "75024",
        "Country": "US"
      },
      "ContactDetails": {
        "FirstNm": "Michael",
        "MiddleNm": "A",
        "LastNm": "Carter",
        "Suffix": "Jr",
        "Phone": "9725550100",
        "PhoneExtn": "205",
        "Email": "horizonllc@sample.com",
        "Fax": "9725550199"
      },
      "ACASpecific": {
        "IsInsurer": false,
        "IsGovernmentalUnit": true
      }
    }
  },
  "ReturnData": [
    {
      "SequenceId": "1",
      "Recipient": {
        "RecipientId": null,
        "PayeeRef": "PAYEE-001",
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "SSN",
          "TIN": "321-44-5789"
        },
        "NameCtrl": "THOM",
        "BusinessNm": null,
        "DBADetails": null,
        "IndividualNm": {
          "FirstNm": "David",
          "MiddleNm": "R",
          "LastNm": "Thompson",
          "Suffix": null
        },
        "Address": {
          "Address1": "780 Market Street",
          "Address2": "Suite 1200",
          "City": " San Francisco",
          "ProvinceOrState": "CA",
          "ZipCd": "94103",
          "Country": "US"
        },
        "Email": "david.thompson@sample.com",
        "Fax": "2145550199",
        "Phone": "2145550100"
      },
      "Form1095BData": {
        "HealthCoverageCd": "D",
        "EmployerSponsoredCoverageDetails": {
          "SponsorNm": "David Baland",
          "EIN": "459878987",
          "Address": {
            "Address1": "123 Main St",
            "Address2": "Suite 1001",
            "City": "Rock Hill",
            "ProvinceOrState": "MA",
            "ZipCd": "02108",
            "Country": "US"
          }
        },
        "CoveredIndividualDetails": [
          {
            "FirstNm": "Steven",
            "MiddleNm": null,
            "LastNm": "David",
            "Suffix": null,
            "SSN": "548678987",
            "DOB": null,
            "IsCoverageAllMonths": false,
            "CoverageMonths": [
              "JAN",
              "MAR",
              "JUN"
            ],
            "Form1099HCData": {
              "SubscriberNum": "4598687",
              "IsFullYearMinimumCreditCoverage": false,
              "MinimumCreditCoverageMonths": [
                "JAN",
                "FEB",
                "MAR"
              ]
            }
          }
        ],
        "Form1099HCData": {
          "SubscriberNum": "4598687",
          "IsFullYearMinimumCreditCoverage": false,
          "MinimumCreditCoverageMonths": [
            "JAN",
            "FEB",
            "MAR"
          ]
        }
      }
    }
  ]
}

Response JSON

Response	Description	Action
200	Success Response - You'll get the below response when the request is processed successfully.

Response: 200

{
  "SubmissionId": "57dc81d7-254f-450c-b12c-f064267f492a",
  "BusinessId": "442b9537-aa24-47d0-af16-596e84671f80",
  "PayerRef": null,
  "DBARef": null,
  "DBAId": null,
  "Form1095Type": "1095-B",
  "Form1095Records": {
    "SuccessRecords": [
      {
        "SequenceId": "1",
        "RecordId": "4adcc213-5855-4bab-9f29-5637be00b459",
        "RecipientId": "69936c40-5438-48b1-bf19-0cb60170ce23",
        "PayeeRef": null,
        "DBARef": null,
        "DBAId": null,
        "Federal": {
          "Status": "CREATED",
          "StatusCd": "FED_001",
          "StatusTs": "2026-07-21 09:40:25 -04:00",
          "Info": null,
          "Errors": null
        },
        "State": {
          "StateCd": "MA",
          "Status": "CREATED",
          "StatusCd": "STATE_001",
          "StatusTs": "2026-07-21 09:40:25 -04:00",
          "Info": "State filing will be submitted via CF/SF",
          "Errors": null
        },
        "Distribution": {
          "DistributionType": "POSTAL_AND_ONLINE",
          "Postal": {
            "PostalType": "USPS_FIRST_CLASS",
            "Status": "CREATED",
            "StatusCd": "POSTAL_001",
            "StatusTs": "2026-07-21 09:40:25 -04:00",
            "Info": "Postal order created"
          },
          "OnlineAccess": {
            "Status": "CREATED",
            "StatusCd": "ONLINE_001",
            "Email": "olivia.harris@sample.com",
            "Info": null
          }
        }
      }
    ],
    "ErrorRecords": null
  },
  "Errors": null
}

W-9/W-8 Automation

1099 Automation

TIN Matching

W-2 Automation

941/940 Automation

1098-T Automation

ACA Automation

Extension Automation

1042-S Automation

Supported Forms

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Healthcare Market Research Platforms

Update

Update

Key points​

Request Body

Response Body

Sample 1

Response: 200

Key points