GenerateFromTxns
GenerateFromTxns
By using the Form1099Transactions endpoint, you can record payouts and transactions made to recipients throughout the year. At the end of the year, you can use the GenerateFromTxns endpoint to generate the applicable 1099-NEC forms for each recipient based on the transactions recorded.
You must include the corresponding BusinessId and RecipientIds in the request JSON. Based on the transactions recorded for those recipients, the system will automatically generate the 1099-NEC forms.
In the response, you’ll receive a SubmissionId and RecordIds, which serve as references for all the other 1099-NEC API endpoints.
Other methods to generate 1099 forms
With the TaxBandits API, you can also generate 1099 forms in the following ways:
-
TaxBandits UI: You can access TaxBandits UI (https://secure.taxbandits.com/login) to generate 1099 forms on your own, based on the transactions recorded. Use your Developer Console credentials to log in. See how
-
Auto-generate: Tax Bandits will automatically generate 1099-NEC for the payee when the total amount for ‘B1NEC’ in the posted transactions reaches the IRS threshold ($600). Once generated, you’ll have the option to review and approve the forms.
Note: If the total ‘B1NEC’ amount for posted transactions is below the $600 threshold, you can still generate the form manually if needed.
POST Form1099NEC/GenerateFromTxns Request Body
| Field | Type | Description |
|---|---|---|
| TaxYear | string | Tax year of Form 1099-NEC to be filed.Allowed values"2023","2024","2025" |
| Business | object | Payer Information. Either PayerRef, BusinessId or TIN is mandatory. |
| PayerRef | string | Optional A unique identifier of the payer given by you. Size Range: ..50 |
| BusinessId | Guid | Optional A unique identifier of the payer generated by TaxBandits. |
| TINType | string | TIN Type of the business.Allowed values"SSN", "EIN" |
| TIN | string | Taxpayer Identification Number of the business. Size Range: 9 |
| Recipients | object[] | Recipient Information. |
| PayeeRef | string | Optional A unique identifier of the recipient given by you. Size Range: 4..20 |
| RecipientId | Guid | Optional A unique identifier of the recipient generated by TaxBandits. |
Response Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | A unique identifier of a submission. |
| BusinessId | Guid | TaxBandits A unique Business Identifier. |
| PayerRef | string | A unique identifier of the payer set by you. |
| Form1099NECRecords | object | Lists the 1099-NEC forms generated |
| SuccessRecords | object[] | It will show the detailed information about the 1099-NEC forms generated. |
| PayeeRef | string | A unique identifier of the recipient set by you. |
| NoOf1099 | number | Shows the number of 1099NECs generated. |
| RecipientId | Guid | A unique identifier of the recipient generated by TaxBandits |
| RecordId | Guid | A unique identifier of the 1099-NEC form generated by TaxBandits. Use this as a future reference to Approve, Update, Delete and Transmit. |
| FederalReturn | object | Federal return information |
| Status | string | Federal return status. |
| StatusTs | string | Status timestamp. |
| Info | string | Additional information on the Federal return (If any) |
| ErrorRecords | object[] | Contains the list of errors |
| PayeeRef | string | A unique identifier of the recipient set by you. |
| RecipientId | Guid | A unique identifier of the recipient generated by TaxBandits. |
| 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 |
| Errors | object[] | Shows the detailed error information |
| Id | string | Validation error ID |
| Name | string | Name of the validation error |
| Message | string | Description of the validation error |
Request JSON
{
"TaxYear": "2024",
"Business": {
"PayerRef": "1473",
"BusinessId": null,
"TINType": null,
"TIN": null
},
"Recipients": [
{
"PayeeRef": "2a-ed6789896",
"RecipientId": "87626E20-75B2-4CB5-A2AC-B65C0105FA5C"
},
{
"PayeeRef": "Alex9608912",
"RecipientId": "A6316079-C3F9-4AAD-BA99-6DF71F635AD3"
}
]
}
Response JSON
Success Response - This is a sample response for successful API requests.
{
"SubmissionId": "8f5c57ec-5c9e-4dee-a650-e79eeb087e4c",
"BusinessId": "1cc352d4-6d91-4fd5-a886-7b59b9fbe2e8",
"PayerRef": "1473",
"NoOf1099": "2",
"Form1099NECRecords": {
"SuccessRecords": [
{
"PayeeRef": "2a-ed6789896",
"RecordId": "5ef596cc-70e2-4258-885c-e5e18d48fa70",
"RecipientId": "87626E20-75B2-4CB5-A2AC-B65C0105FA5C",
"NECBox1": "10000",
"NECBox4": "2000",
"FederalReturn": {
"Status": "CREATED",
"StatusTs": "2025-10-14 10:58:19 +05:30",
"Info": null
}
},
{
"PayeeRef": "Alex9608912",
"RecordId": "5ef596cc-70e2-4258-885c-e5e18d48ff78",
"RecipientId": "A6316079-C3F9-4AAD-BA99-6DF71F635AD3",
"NECBox1": "10000",
"NECBox4": "2000",
"FederalReturn": {
"Status": "CREATED",
"StatusTs": "2025-10-14 10:58:19 +05:30",
"Info": null
}
}
],
"ErrorRecords": null
},
"Errors": null
}