List
Lists all Form 1099-R returns created and transmitted on the account for a particular Submission or Payer. Form 1099-R returns will be listed based on the filters sent in the Request.
GET Form1099R/List 
Request Params
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier of a submission |
| BusinessId | Guid | Unique identifier of a business |
| TINType | string | List the1099-R records based on the given TINType and TIN. |
| TIN | string | List the1099-R records based on the given TIN. |
| TaxYear | string | List the1099-R records based on the given taxyear. Allowed values: "2022","2023","2024" |
| Page | number | Pulls the records listed in the page selected |
| PageSize | number | Number of1099-R records to be listed in each page. |
| EfileStatus | string | List the1099-R records based on the status ("CREATED, UNDERPROCESS, SENTTOAGENCY, TRANSMITTED, ACCEPTED, REJECTED") |
| FromDate | string | Enter a date from which the Form 1099-R records need to be listed in MM/DD/YYYY format. |
| ToDate | string | Enter a date till which the 1099-R records created are to be listed in MM/DD/YYYY format. |
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-R records. |
| SubmissionId | Guid | Unique identifier of a submission |
| BusinessId | Guid | Unique identifier of a business |
| PayerRef | string | Unique identifier of the payer. |
| BusinessNm | string | Name of the business |
| FirstNm | string | First Name of the Individual |
| MiddleNm | string | Middle Name of the Individual |
| LastNm | string | Last Name of the Individual |
| Suffix | string | Suffix of the Individual |
| 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 of1099-R 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-R return is created. |
| RecipientId | Guid | A unique identifier generated by TaxBandits for a Recipient when a 1099-R return is created. You can use this id for your future reference to Update. |
| RecipientNm | Boolean | Name of Recipient. |
| FirstNm | string | First Name of the Individual |
| MiddleNm | string | Middle Name of the Individual |
| LastNm | string | Last Name of the Individual |
| Suffix | string | Suffix of the Individual |
| TINType | string | TIN type of the Recipient. |
| TIN | string | TIN of the Recipient. |
| PayeeRef | string | A unique identifier for each payee completing their information. |
| AccountNum | string | Account number of Payer having multiple accounts for a recipient for whom more than one Form 1099-NEC is filed. Size Range: 4..20 Note: If the account number on the return you file is the same as any previously filed return, TaxBandits will append 3 random numbers at the end of the account number. |
| Status | string | The status of Form 1099-R. |
| 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 of1099-R 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 |
- Request Params
- Node.js
- Python
- Java
- .NET C#
List all the 1099-R returns created for the particular BusinessId, RecordID and Tax year.
"Form1099R/List?BusinessId=f87e6f65-b036-4cad-9c20-a03200d9a1c7"
Response Json
| Response | Description | Action |
|---|---|---|
| 200 | Success Response - This is a sample response for successful API requests. |
Response: 200
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"Form1099Type": "R",
"Form1099Records": [
{
"SubmissionId": "2510630e-186d-4916-975c-f5b100808d73",
"BusinessId": "f87e6f65-b036-4cad-9c20-a03200d9a1c7",
"PayerRef": "RN123",
"BusinessNm": "Snowdaze LLC",
"FirstNm": null,
"LastNm": null,
"MiddleNm": null,
"Suffix": null,
"IsEIN": true,
"EINorSSN": "62-2269245",
"ContactNm": "Chandler White",
"TaxYear": "2024",
"Recipient": {
"SequenceId": "1",
"RecordId": "1974a146-5808-44c6-a27f-158d9c35f31f",
"RecipientId": "9b0beedf-c980-404b-9c33-1007f5ff943c",
"RecipientNm": "Stephen Davis",
"FirstNm": null,
"LastNm": null,
"MiddleNm": null,
"Suffix": null,
"TINType": "EIN",
"TIN": "56-3817572",
"PayeeRef": "Payee001",
"AccountNum": "20241520058563079953",
"FederalReturn": {
"Status": "CREATED",
"StatusTs": "2024-06-29 04:07:59 -04:00",
"Info": null,
"Errors": null
},
"StateReturns": [
{
"StateCd": "PA",
"Status": "CREATED",
"StatusTs": "2024-06-29 03:59:41 -04:00",
"Info": null,
"Errors": null
},
{
"StateCd": "AZ",
"Status": "CREATED",
"StatusTs": "2024-06-29 03:59:41 -04:00",
"Info": null,
"Errors": null
}
],
"Postal": {
"Status": "CREATED",
"StatusTs": "2024-06-29 04:07:59 -04:00",
"Info": null
},
"OnlineAccess": {
"Status": "CREATED",
"Email": "mark@sample.com",
"Info": null
}
}
} ],
"TotalRecords": 2,
"TotalPages": 1,
"Page": 1,
"PageSize": 100,
"Errors": null
}