List
Lists all Form 1099-NEC returns in TaxBandits that have been created and transmitted for a Submission or Payer. Based on the filters supplied in the request, the results will be listed. If you provide a BusinessId, for example, all returns created under that BusinessId will be listed.
GET Form1099NEC/List
Request Body
Field | Type | Description |
---|---|---|
SubmissionId | Guid | Unique identifier of a submission |
BusinessId | Guid | Unique identifier of a business |
TINType | string | List the 1099 NEC records based on the given TINType and TIN. |
TIN | string | List the 1099 NEC records based on the given TIN. |
TaxYear | string | List the 1099 NEC records based on the given taxyear. |
Page | number | Pulls the records listed in the page selected |
PageSize | number | Number of 1099 NEC records to be listed in each page. |
EfileStatus | string | List the 1099 NEC records based on the status ("CREATED, UNDERPROCESS, SENTTOAGENCY, TRANSMITTED, ACCEPTED, REJECTED") |
FromDate | string | List 1099 NEC records created from |
ToDate | string | List 1099 NEC records created up to |
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 NEC records. |
SubmissionId | Guid | Unique identifier of a submission |
BusinessId | Guid | Unique identifier of a Business. |
PayerRef | string | Unique identifier of a Payer. |
BusinessNm | string | Name of the business |
IsEIN | Boolean | When true, identifies the business with an EIN. |
EINorSSN | string | Employer Identification Number or Social Security Number. |
ContactName | string | Name of the person who can be contacted by the IRS. |
TaxYear | string | Tax Year of Form Nec to be filed. Allowed Values: "2021", "2022". |
Recipient | object | Returns the recipient details. |
SequenceId | string | An 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 | An unique identifier generated by TaxBandits when a 1099-NEC return is created. |
RecipientId | Guid | An unique identifier generated by TaxBandits for a Recipient when a 1099-NEC return is created. You can use this id for your future reference to Update. |
RecipientNm | String | Name of Recipient. |
TINType | String | TIN type of the Recipient. |
TIN | string | TIN of the Recipient. |
FederalReturn | object | Returns the record status and StatusTs of federal return. |
Status | string | Returns the record status. |
StatusTs | string | Returns date and time of return created. |
Info | string | Returns information about the Federal Filing service. |
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 |
StateReturns | object[] | Returns collection of state returns information |
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. |
StatusTs | string | Date and time of the return created. |
Info | string | Returns the information about the state for which we are not supporting state filing. |
Errors | object[] | Shows error information of state returns of Form W2 |
Id | string | Returns the validation error Id. |
Name | string | Name of the validation error. |
Message | string | Description of the validation error. |
Postal | object | Returns the status and StatusTs of postal mailing service for Form W2. |
Status | string | Returns the status of postal order. |
StatusTs | string | Returns the date and time of the postal order created. |
Info | string | Returns the information about Postal mailing service. |
OnlineAccess | object | Returns the Email address for whom the online access to be given and Status of online access. |
Status | string | Returns the Status of the Online Access. |
string | Email address for whom the online access to be given. | |
Info | string | Information about the online access service. |
TotalRecords | number | Total number of records listed in the response. |
TotalPages | number | Total number of pages |
Page | number | Returns the page number in which the records are listed |
PageSize | number | Number of records 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 JSON: List all the 1099-NEC returns created for the particular BusinessId, RecordID and Tax year.
"Form1099NEC/List?SubmissionId=1a333c54-1d01-41bf-8283-f43211e918c4&BusinessId=8d6e3938-2af4-41d2-ba02-17796f00aae2&TINType=SSN&TIN=092115111&TaxYear=2022&Page=1&PageSize=10&EfileStatus=ALL&FromDate=11-01-2022&ToDate=11-30-2022"
Response JSON: The Response Payload will list all the returns created for the given BusinessId.
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"Form1099Type": "NEC",
"Form1099Records": [
{
"SubmissionId": "099c7fd8-6b39-49b3-b30a-d0f64bfdc334",
"BusinessId": "d6fb8f6e-2a1b-4a75-9178-08a22a4a9cf8",
"PayerRef": null,
"BusinessNm": "Foctrom Trade",
"IsEIN": true,
"EINorSSN": "24-1817196",
"ContactNm": "Kain",
"TaxYear": "2022",
"Recipient": {
"SequenceId": "01",
"RecordId": "e0e93adc-e4ca-4eb0-9900-e0aadd0b6e22",
"RecipientId": "70de8671-9ff7-4a2a-afb3-5afac01470c4",
"RecipientNm": "Berny Charles",
"TINType": "SSN",
"TIN": "841-54-2348",
"FederalReturn": {
"Status": "CREATED",
"StatusTs": "2023-03-08 05:38:05 +00:00",
"Info": null,
"Errors": null
},
"StateReturns": [
{
"StateCd": "TX",
"Status": "NOTCREATED",
"StatusTs": null,
"Info": "Texas does not require 1099 Filing",
"Errors": null
},
{
"StateCd": "SC",
"Status": "Created",
"StatusTs": "2023-03-08 10:38:49 +00:00",
"Info": null,
"Errors": null
}
],
"Postal": {
"Status": "CREATED",
"StatusTs": "2023-03-08 05:38:04 +00:00",
"Info": null
},
"OnlineAccess": {
"Status": "CREATED",
"Email": "Alico@gmail.com",
"Info": null
}
}
}
],
"Page": 1,
"TotalRecords": 1,
"TotalPages": 1,
"PageSize": 100,
"Errors": null
}