Extend your software with TaxBandits IRS E-file API Integration

Skip to main content
Version: 1.7.1

Delete

You can delete the existing Form 1099 NEC returns created in TaxBandits. To delete an existing return, refer to it using unique identifiers such as SubmissionId, RecordId, and so on. A Transmitted return cannot be deleted. If you only provide the SubmissionId, all of the results that match that ID will be deleted.

DELETE Form1099NEC/Delete

Request Body

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission
RecordIdsGuid[]An unique identifier generated by TaxBandits when a 1099-NEC return is created. Mention the 1099-NEC return's Record ID that you want to delete.

Response Body

FieldTypeDescription
StatusCodenumberReturns the HTTP status codes like 200,300 etc.
StatusNamestringName of the status code
StatusMessagestringDetailed status message
SubmissionIdGuidUnique identifier of a submission
Form1099RecordsobjectPulls the Form 1099 NEC records with Success and Error statuses
    SuccessRecordsobject[]It will show the detailed information about the success status of Form 1099 NEC Records
        SequenceIdstringA unique number given by an inbound application to identify failed records
        RecordIdGuidUnique identifier of a record
        StatusstringReturns the status of the records.
        StatusTsstringDate and time of return deleted.
    ErrorRecordsobject[]It will show the detailed information about the error status of Form 1099 NEC Records.
        SequenceIdstringA unique number given by an inbound application to identify failed records
        RecordIdGuidUnique identifier of a record
        Errorsobject[]Shows detailed error information
            IdstringReturns the validation error code
            NamestringName of the validation error
            MessagestringDescription of the validation error
Errorsobject[]Shows detailed error information
    IdstringReturns the validation error code
    NamestringName of the validation error
    MessagestringDescription of the validation error

Request JSON: Delete an existing form 1099-NEC return for the given SubmissionId and RecordId.

Form1099NEC/Delete?SubmissionId=9d71ae45-df5f-49f7-86f8-e88f54132fa1&RecordIds=01132f6d-ef4a-4014-817e-94a5a19bd52b,eb39714e-f653-4c4d-a53c-07f24f9a9dj5

Response JSON: Based on the SubmissionId, the response will delete the returns under the specified RecordId.

{   "StatusCode": 200,   "StatusName": "Ok",   "StatusMessage": "Successful API call","SubmissionId": "9d71ae45-df5f-49f7-86f8-e88f54132fa1",   "Form1099Records": {       "SuccessRecords": [           {               "SequenceId": "1",               "RecordId": "15c3caa6-8402-4548-8713-4fcdd2f7d42d",               "Status": "DELETED",               "StatusTs": "2021-08-05 06:26:16 -04:00"           },           {               "SequenceId": "2",               "RecordId": "eb39714e-f653-4c4d-a53c-07f24f9a9dj5",               "Status": "DELETED",               "StatusTs": "2021-08-05 06:26:16 -04:00"           }       ],       "ErrorRecords": null   },   "Errors": null}