Skip to main content
Version: 1.7.3

Delete

This endpoint can be used to delete a particular W-9 request or a submission. If there are multiple W-9 requested in a submission, all the W-9 records under the submission will be deleted.

DELETE FormW9/Delete 
Run in Postman

Request Params

FieldTypeDescription
SubmissionIdGuidA unique identifier of the submission.
PayeeRefStringA Unique identifier of the recipient.
(Either PayeeRef or Email is required)
Size Range: 1-50
EmailStringEmail address of the recipient.
Size Range: 1-50

Request Params

Delete a recipient with SubmissionId

FormW9/Delete?SubmissionId=019c8aec-41fe-4b80-883a-441665dc004a

Response Body

FieldTypeDescription
FormW9RecordsObject[]Details of the W-9s requested to be deleted.
    SubmissionIdGuidA Unique identifier of the submission
    PayeeRefStringA Unique identifier of the recipient
    EmailStringEmail Address of the recipient.
    W9StatusStringStatus of the W-9
    StatusTsStringTimestamp of the W-9 Status
ErrorsObject[]Detailed error information.
    IdstringError ID number. This ID is assigned by TaxBandits and it is unique for each error.
    NamestringName of the errored node.
    MessagestringShows the error message

Response JSON

All W-9s will be deleted for the given SubmissionId.

{
"FormW9Records": [
{
"SubmissionId": "019c8aec-41fe-4b80-883a-441665dc004a",
"PayeeRef": "Pe123451234",
"Email": "mark@sample.com",
"W9Status": "DELETED",
"StatusTs": "2021-02-22 04:24:09 -05:00"
}
],
"Errors": null
}