Skip to main content
Version: 1.7.3

Approve

Approve

This endpoint will be applicable only if you’ve generated 1099-MISC forms using the ‘GenerateFromTxns’ method.

Once TaxBandits generates the draft 1099-MISC forms, you can use this endpoint to approve them. Once approved, you will be able to transmit the forms using the Transmit endpoint.

POST Form1099MISC/Approve 

Request Body

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission.
RecordIdsGuid[]List of record Ids to get the Approved Form 1099-MISC.

Response Body

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission.
Form1099MISCRecordsobjectContains Form 1099MISC records that are approved.
    SuccessRecordsobject[]Contains detailed information of Form 1099 MISCs that were successfully approved.
        RecordIdstringUnique identifier of a record
        StatusGuidStatus of the 1099-MISC.
        StatusTsGuidReturns date and time of return created.
    ErrorRecordsobject[]Contains the list of errors
        PayeeRefstringUnique identifier of the recipient. Set by the client.
        RecipientIdGuidUnique 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": "494f2e25-c1b7-490f-814a-65b573c9d342",
"RecordIds": [
"80d90736-2c6b-43a4-8561-7c66a090ed5f"
]
}

Response JSON

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

{
"SubmissionId": "494f2e25-c1b7-490f-814a-65b573c9d342",
"Form1099MISCRecords": {
"SuccessRecords": [
{
"RecordId": "80d90736-2c6b-43a4-8561-7c66a090ed5f",
"Status": "CREATED",
"StatusTs": "2025-10-28 09:24:43 -04:00"
}
],
"ErrorRecords": null
},
"Errors": null
}