List
List
GET Form1099SCorrection/List Request Params
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | This is a Unique Identifier of a Submission. Use this node, if you want to list the 1099 S correction records created under a Submission. Ignore this node, if you want to list the records of a particular Payer. |
| BusinessId | Guid | This is a Unique Identifier of a Payer. Use this node, if you want to list all the 1099 S correction records created under the Payer. Ignore this node, if you want to list the records for a Submission. |
| TINType | string | Mention TIN type and TIN, if you do not have Business ID and want to list all the 1099 S correction records created under a Payer. Allowed Values : "EIN" ,"SSN" |
| TIN | string | Employer Identification Number or Social Security Number of the Payer is required only when you have not provided the SubmissionId or the BusinessId. |
| TaxYear | string | List the 1099 S correction based on the given taxyear. Allowed values:"2023","2024","2025" |
| Page | number | Mention the page number that needs to be listed in the Response. If the value is not given, the page will be defaulted to 1. |
| PageSize | number | Provide a numerical value to list the total number of Form 1099 S correction records in each page. If the value is not given, then the page size will be defaulted to 1000. Note: PageSize can be maximum of 100. |
| EfileStatus | string | Mention Form 1099 S correction record status that needs to be listed. If the value is not given, then records with all the statuses will be listed. |
| FromDate | string | Enter a date from which the Form 1099 S correction records need to be listed in MM/DD/YYYY format. |
| ToDate | string | Enter a date till which the 1099 S correction 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 | Submission Status |
| StatusMessage | string | Status Details |
| Form1099Type | string | Denotes the type of 1099 form. |
| Form1099Records | object[] | It contains list of 1099 S correction records. |
| SubmissionId | Guid | Unique Identifier of a Payer. |
| BusinessId | Guid | Unique identifier of a business. |
| BusinessNm | string | Payer's Name. |
| 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 |
| EINorSSN | string | Payer's EIN or SSN or Payer's Employer Identification Number or Social Security Number |
| ContactNm | string | Contact Name of the Payer. |
| TaxYear | string | Tax year of the 1099 S correction records. |
| Recipient | object | Recipient Details. |
| SequenceId | string | Sequence ID of the 1099 S correction record provided during CREATE or UPDATE |
| RecordId | Guid | Unique identifier of the 1099 S correction record. |
| RecipientId | Guid | Unique identifier of the Recipient. |
| RecipientNm | Boolean | Recipient's Name. |
| 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 | Recipient's TIN Type. |
| TIN | string | Recipient's TIN. |
| Status | string | Record Status of Form 1099 S correction. |
| 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 error information of federal returns of Form 1099 S correction. |
| StateReturns | object[] | Returns collection of state returns information |
| Postal | object | Returns the status and StatusTs of postal mailing service for Form 1099 S correction. |
| 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 status of online access for Form 1099 S correction return. |
| 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. |
| TotalPages | number | Total number of pages. |
| Page | number | Pulls the records listed in the page selected |
| PageSize | number | Total 1099 S correction records in the 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
Form1099SCorrection/List?BusinessId=d5c7f8a1-a23c-4428-a503-5707ce6c056c&EINorSSN=748903602&TINType=EIN&TaxYear=2023&Page=1&PageSize=1&FromDate=01/01/2025&ToDate=01/11/2025&TIN=74-8903602
Response Json
Success Response - This is a sample response for successful API requests.
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"Form1099Type": "SCorrection",
"Form1099Records": [
{
"SubmissionId": "386548ab-5f72-44cc-80ff-58f344a403fa",
"BusinessId": "d5c7f8a1-a23c-4428-a503-5707ce6c056c",
"BusinessNm": "Snowdaze LLC",
"FirstNm": null,
"MiddleNm": null,
"LastNm": null,
"Suffix": null,
"EINorSSN": "74-8903602",
"ContactNm": "James Smith",
"TaxYear": "2025",
"Recipient": {
"SequenceId": "001",
"RecordId": "4b6111d5-e592-4b50-ae3b-ee1cccf01c89",
"RecipientId": "f64381b9-d1c0-4dff-94bf-93fed6cd6cff",
"RecipientNm": "Dairy Delights LLC Coco Milk",
"FirstNm": null,
"MiddleNm": null,
"LastNm": null,
"Suffix": null,
"TINType": "EIN",
"TIN": "45-6251017",
"Status": "CREATED",
"FederalReturn": {
"Status": "CREATED",
"StatusTs": "2025-01-11 07:13:27 -05:00",
"Info": null,
"Errors": null
},
"Postal": {
"Status": "CREATED",
"StatusTs": "2025-01-11 07:13:27 -05:00",
"Info": null
},
"OnlineAccess": {
"Status": "NA",
"Email": null,
"Info": "This Service will be available soon"
}
}
}
],
"Page": 1,
"TotalRecords": 1,
"TotalPages": 1,
"PageSize": 1,
"Errors": null
}