Skip to main content
Version: 1.7.3

Approve

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

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

POST Form1099NEC/Approve 
Run in Postman

Request Body

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

Request JSON

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

Response Body

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission.
Form1099NECRecordsobjectContains Form 1099NEC records that are approved.
    SuccessRecordsobject[]Contains detailed information of Form 1099 NECs that were successfully approved.
        RecordIdstringUnique identifier of a record
        StatusGuidStatus of the 1099-NEC.
        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

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": "2021-12-03 03:06:58 -05:00"
},
{
"RecordId": "7d403f42-3533-41bd-9c9e-c2cb6f1cb365",
"Status": "CREATED",
"StatusTs": "2021-12-03 03:06:58 -05:00"
}
],
"ErrorRecords": null
},
"Errors": null
}