Skip to main content
Version: 1.7.3

Approve

Approve

This endpoint can be used to approve the 1099-NEC forms generated by using the ‘GenerateFromTxns’ endpoint. Once the forms are approved, you’ll be able to transmit them using the ‘Transmit’ endpoint.

POST Form1099NEC/Approve 

Request Body

FieldTypeDescription
SubmissionIdGuidA unique identifier of a submission.
RecordIdsGuid[]List of 1099-NEC record IDs to be Approved.

Response Body

FieldTypeDescription
  SubmissionIdGuidA unique identifier of a submission.
Form1099NECRecordsobjectContains Form 1099NEC records that are approved.
    SuccessRecordsobject[]Contains detailed information on Form 1099 NECs that were successfully approved.
        RecordIdstringA unique identifier of a record
        StatusGuidStatus of the 1099-NEC.
        StatusTsGuidReturns the date and time of return created.
    ErrorRecordsobject[]Contains the list of errors
        PayeeRefstringA unique identifier of the recipient set by you.
        RecipientIdGuidA unique identifier of the recipient generated by TaxBandits.
        Errorsobject[]Shows detailed error information
            IdstringReturns the validation error ID
            NamestringName of the validation error
            MessagestringDescription of the validation error
      Errorsobject[]Shows the detailed error information
      IdstringValidation error ID
      NamestringName of the validation error
      MessagestringDescription of the validation error

Request JSON

{
"SubmissionId": "ed4eb5c4-cc6a-4b34-8253-ac326674fb41",
"RecordIds": [
"f53d6303-9d48-4ed8-8d4a-5b6713392e47",
"7d403f42-3533-41bd-9c9e-c2cb6f1cb365"
]
}

Response JSON

Success Response - This is a sample response for successful API requests.

{
"SubmissionId": "ed4eb5c4-cc6a-4b34-8253-ac326674fb41",
"Form1099NECRecords": {
"SuccessRecords": [
{
"RecordId": "f53d6303-9d48-4ed8-8d4a-5b6713392e47",
"Status": "CREATED",
"StatusTs": "2025-12-03 03:06:58 -05:00"
},
{
"RecordId": "7d403f42-3533-41bd-9c9e-c2cb6f1cb365",
"Status": "CREATED",
"StatusTs": "2025-12-03 03:06:58 -05:00"
}
],
"ErrorRecords": null
},
"Errors": null
}