List
Lists all Form 1099-DIV returns created and transmitted on the account for a particular Submission or Payer. Form 1099-DIV returns will be listed based on the filters sent in the Request.
GET Form1099DIV/List
Request Params
Field | Type | Description |
---|---|---|
SubmissionId | Guid | Unique identifier of a submission |
BusinessId | Guid | Unique identifier of a business |
TINType | string | List the 1099-DIV records based on the given TINType and TIN. |
TIN | string | List the 1099-DIV records based on the given TIN. |
TaxYear | string | List the 1099-DIV records based on the given taxyear. Allowed values: "2022","2023" |
Page | number | Pulls the records listed in the page selected |
PageSize | number | Number of 1099-DIV records to be listed in each page. |
EfileStatus | string | List the 1099-DIV records based on the status ("CREATED, UNDERPROCESS, SENTTOAGENCY, TRANSMITTED, ACCEPTED, REJECTED") |
FromDate | string | Enter a date from which the Form 1099-DIV records need to be listed in MM/DD/YYYY format. |
ToDate | string | Enter a date till which the 1099-DIV records created are to be listed in MM/DD/YYYY format. |
Request Params
"Form1099DIV/list?BusinessId=b1c21945-26b0-4dda-af2c-8288344e207e"
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 |
Form1099Type | string | Denotes the type of 1099 form. |
Form1099Records | object[] | Returns detailed information of the Form 1099-DIV records. |
SubmissionId | Guid | Unique identifier of a submission |
BusinessId | Guid | Unique identifier of a business |
PayerRef | string | An unique identifier for each payer completing their information. This identifier can be used in future references of the payer in the API |
BusinessNm | string | Name of the business |
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) |
ContactNm | string | Contact Name of the Business. |
TaxYear | string | Tax year of 1099-DIV to be filed. |
Recipient | object | Details of the Recipient. |
SequenceId | string | A unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the Response for your reference. |
RecordId | Guid | A unique identifier generated by TaxBandits when a 1099-DIV return is created. |
RecipientId | Guid | A unique identifier generated by TaxBandits for a Recipient when a 1099-DIV return is created. You can use this id for your future reference to Update. |
RecipientNm | Boolean | Name of Recipient. |
TINType | string | TIN type of the Recipient. |
TIN | string | TIN of the Recipient. |
Status | string | The status of Form 1099-DIV. |
TotalRecords | number | Total number of records. |
TotalPages | number | Total number of pages. |
Page | number | Pulls the records listed in the page selected |
PageSize | number | Number of 1099-DIV records to be listed in each page. |
Errors | 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 |
Response JSON
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"Form1099Type": "DIV",
"Form1099Records": [
{
"SubmissionId": "625ca394-dd09-4580-a084-f309b017c6d8",
"BusinessId": "b1c21945-26b0-4dda-af2c-8288344e207e",
"PayerRef": "Snow123",
"BusinessNm": "Snowdaze LLC",
"IsEIN": true,
"EINorSSN": "62-7369245",
"ContactNm": "Chandler White",
"TaxYear": "2023",
"Recipient": {
"SequenceId": "1",
"RecordId": "a21f67a0-4b91-4cb8-8270-409c3ecce2f9",
"RecipientId": "92f8d733-bbb4-442a-87b7-bb18ef3ab877",
"RecipientNm": "Mark Davis",
"TINType": "SSN",
"TIN": "393-81-7572",
"FederalReturn": {
"Status": "CREATED",
"StatusTs": "2024-04-02 01:28:26 -04:00",
"Info": null,
"Errors": null
},
"StateReturns": [
{
"StateCd": "PA",
"Status": "NOTCREATED",
"StatusTs": null,
"Info": "TaxBandits currently does not support 1099-DIV state filing for Pennsylvania",
"Errors": null
},
{
"StateCd": "AZ",
"Status": "Created",
"StatusTs": "2024-04-02 01:20:59 -04:00",
"Info": null,
"Errors": null
}
],
"Postal": null,
"OnlineAccess": {
"Status": "CREATED",
"Email": "mark@sample.com",
"Info": null
}
}
},
{
"SubmissionId": "625ca394-dd09-4580-a084-f309b017c6d8",
"BusinessId": "b1c21945-26b0-4dda-af2c-8288344e207e",
"PayerRef": "Snow123",
"BusinessNm": "Snowdaze LLC",
"IsEIN": true,
"EINorSSN": "62-7369245",
"ContactNm": "Chandler White",
"TaxYear": "2023",
"Recipient": {
"SequenceId": "1",
"RecordId": "8ce1aa59-0f4a-415a-ac11-865568d8e901",
"RecipientId": "92f8d733-bbb4-442a-87b7-bb18ef3ab877",
"RecipientNm": "Mark Davis",
"TINType": "SSN",
"TIN": "393-81-7572",
"FederalReturn": {
"Status": "CREATED",
"StatusTs": "2024-04-02 01:20:59 -04:00",
"Info": null,
"Errors": null
},
"StateReturns": [
{
"StateCd": "PA",
"Status": "NOTCREATED",
"StatusTs": null,
"Info": "TaxBandits currently does not support 1099-DIV state filing for Pennsylvania",
"Errors": null
},
{
"StateCd": "AZ",
"Status": "Created",
"StatusTs": "2024-04-02 01:20:59 -04:00",
"Info": null,
"Errors": null
}
],
"Postal": null,
"OnlineAccess": {
"Status": "CREATED",
"Email": "mark@sample.com",
"Info": null
}
}
}
],
"TotalRecords": 2,
"TotalPages": 1,
"Page": 1,
"PageSize": 100,
"Errors": null
}