Get

Get

Use this endpoint to retrieve a 1095-B submission and its records. Provide the SubmissionId to retrieve the whole submission, optionally narrowing to a specific RecordId.

The response includes the full payer, recipient, and form data as originally submitted — useful for audit trails and displaying return details in your application.

GETform1095b/Get

Run in Postman

Request Params

Field	Type	Description
SubmissionId	GUID	An unique identifier generated by TaxBandits when a 1095-B return is created. Mention the Form 1095-B return's Submission ID that you want to get.
RecordIds	GUID	An unique identifier generated by TaxBandits when a 1095-B return is created. Mention the Form 1095-B return's Record ID that you want to get.

Response Body

Field	Type	Description
Form1095Records	object[]	Contains information about Form 1095-B returns.
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.
TaxYear	String	Tax year for which Form 1095-B is filed.
IsFederal	Boolean	Federal Filing for the return will be enabled when the value is True.
IsState	Boolean	State Filing for the return will be enabled when the value is True. Note: State Filing will not be created for the states that do not require State filing.
IsDistribution	Boolean	When TRUE, recipient distribution is enabled (postal mail / online access/email).
DistributionDetails	object[]	Distribution configuration. Required when IsDistribution is TRUE.
DistributionType	String	Recipient copy distribution type. Allowed values "POSTAL_ONLY", "ONLINE_ACCESS", "POSTAL_AND_ONLINE".
PostalType	String	Postal service type. Allowed values "USPS_FIRST_CLASS".
ReturnHeader	object	Contains information about the Business details.
Business	object	Object to identify the Business Details.
BusinessId	GUID	Unique identifier of the business generated by TaxBandits.
PayerRef	String	Your unique identifier for the payer.
IsDefaultBusiness	Boolean	Identifies whether the business is designated as the default business.
TINDetails	object	Returns the TIN information for the business.
Format	String	Returns the format of the TIN passed.
TINType	String	Returns the TIN type of the business.
TIN	String	Returns the TIN value according to the Format selected.
IndividualNm	object	Returns the individual's name details when the TIN type of the business is "SSN".
FirstNm	String	First name of the individual.
MiddleNm	String	Middle name of the individual.
LastNm	String	Last name of the individual.
Suffix	String	The suffix of the individual's name.
BusinessNm	String	Legal name of the business.
NameCtrl	String	Name control of the business as registered with the IRS.
DBADetails	object[]	Returns DBA (Doing Business As) information.
DBANm	String	Name of the DBA.
DBARef	String	Your unique identifier for this DBA.
DBAId	GUID	Unique identifier of the DBA generated by TaxBandits.
Address	object[]	Returns address information of DBA.
Address1	String	Street address or PO Box.
Address2	String	Suite or apartment number.
City	String	DBA's city.
ProvinceOrStateNm	String	DBA's province or state name.
Zipcd		DBA's ZIP code.
Country	String	DBA's 2-character country code.
Address	object	Returns primary address of the business.
Address1	String	Street address or PO Box of the business.
Address2	String	Suite or apartment number of the business.
City	String	City of the business.
ProvinceOrStateNm	String	Province or state name of the business.
ZipCd	String	ZIP code of the business.
Country	String	2-character country code of the business.
ContactDetails	object	Returns details of the person the IRS can contact regarding this business.
FirstNm	String	First name of the contact person.
MiddleNm	String	Middle name of the contact person.
LastNm	String	Last name of the contact person.
Suffix	String	The suffix of the contact person.
Phone	String	Phone number of the contact person.
PhoneExtn	String	Phone extension number.
Email	String	Email address of the contact person.
Fax	String	Fax number of the contact person.
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	A unique reference ID for the submission that can be used to identify a particular record.
RecordId	GUID	An unique identifier generated by TaxBandits when a 1095-B return is created.
Recipient	object	Object to identify the recipient details.
RecipientId	GUID	Unique identifier of the recipient generated by TaxBandits.
PayeeRef	String	Your unique identifier for the recipient.
TINDetails	object	Returns the TIN information for the recipient.
Format	String	Returns the format of the TIN passed.
TINType	String	Returns the TIN type of the recipient.
TIN	String	Returns the TIN value according to the Format selected.
IndividualNm	Object	Returns the individual's name details when the TIN type of the recipient is "SSN".
FirstNm	String	The first name of the individual.
MiddleNm	String	The middle name of the individual.
LastNm	String	The last name of the individual.
Suffix	String	The suffix of the individual's name.
BusinessNm	String	Legal name of the recipient's business.
NameCtrl	String	Name control of the recipient as registered with the IRS.
DBADetails	Object	Returns DBA (Doing Business As) information.
DBAId	GUID	Name of the DBA.
DBANm	String	Your unique identifier for this DBA.
DBARef	String	Unique identifier of the DBA generated by TaxBandits.
Address	Object	Identifies whether the DBA is designated as the default DBA.
Address1	String	Returns address information of DBA.
Address2	String	Suite or apartment number.
City	String	DBA's city.
ProvinceOrState	String	DBA's province or state name.
ZipCd	String	DBA's ZIP code.
Country	String	DBA's 2-character country code.
Address	Object	Returns primary address of the recipient.
Address1	String	Street address or PO Box of the recipient.
Address2	String	Suite or apartment number of the recipient.
City	String	City of the recipient.
ProvinceOrState	String	Province or state name of the recipient.
ZipCd	String	ZIP code of the recipient.
Country	String	2-character country code of the recipient.
DOB	String	Returns Date of Birth of the recipient.
Email	String	Email address of the recipient.
Fax	String	Fax number of the recipient.
Phone	String	Phone number of the recipient.
PhoneExtn	String	Phone extension number.
ReturnData	object[]	Contains information about the recipient details and Form 1095-B details.
Form1095BData	Object	Form 1095-B details for the recipient.
HealthCoverageCd	String	Code identifying Origin of the Health Coverage.
EmployerSponsoredCoverageDetails	Object	Object identifying Employer-Sponsored Coverage details.
SponsorNm	String	Name of the sponsor.
EIN	String	Employer Identification Number of the Sponsor.
Address	Object	Address information of Sponsor.
Address1	String	Street address or PO Box of Sponsor.
Address2	String	Suite or apartment number.
City	String	Sponsor's city.
ProvinceOrState	String	Sponsor's province or state name.
ZipCd	String	Sponsor's ZIP code.
Country	String	Sponsor's 2-character country code.
CoveredIndividualDetails	Object []	Object identifying Covered Individual's details of the recipient.
FirstNm	String	First name of the covered individual.
MiddleNm	String	Middle name of the covered individual.
LastNm	String	Last name of the covered individual.
Suffix	String	Suffix of the covered individual.
SSN	String	Social Security Number of the covered individual.
DOB	Date	Date of birth of the covered individual.
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.
Form1099HCData	Object	Massachusetts Form 1099-HC information for the covered individual.
SubscriberNum	String	Subscriber number of the covered individual.
IsFullYearMinimumCreditCoverage	Boolean	If true, indicates that the covered individual had full-year minimum creditable coverage.
MinimumCreditCoverageMonths	Object []	Months with minimum creditable coverage.
Form1099HCData	Object	Massachusetts Form 1099-HC information for the covered individual.
SubscriberNum	String	Subscriber number of the covered individual.
IsFullYearMinimumCreditCoverage	Boolean	If true, indicates that the covered individual had full-year minimum creditable coverage.
MinimumCreditCoverage	Object	Months with minimum creditable coverage.
MonthsErrors	object[]	Shows detailed error information.
Id	String	Returns the validation error ID.
Name	String	Name of the validation error.
Message	String	Description of the validation error.

Payload

Request JSON

Sample	Description	Action
Sample 1	Retrieve a specific record by SubmissionId and RecordId
Sample 2	Retrieve the complete submission without specifying RecordIds

Sample 1

form1095b/get?SubmissionId=4fc3dc91-64fe-4877-9193-7c520c21896a&recordIds=53EB195D-4914-4A14-9348-251A55909C1D 

Response JSON

Response	Description	Action
400	Bad Request Response - You'll get the below response when your API requests contain any validation errors.

Response: 400

{
  "Form1095BRecords": null,
  "Errors": [
    {
      "Id": "C00-000196",
      "Name": "SubmissionId or RecordIds",
      "Message": "Either SubmissionId or RecordIds must be provided, but not both."
    }
  ]
}