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 

Request Params

Field	Type	Description
SubmissionId	Guid	A unique identifier of the submission.
PayeeRef	String	A Unique identifier of the recipient. (Either PayeeRef or Email is required) Size Range: 1-50
Email	String	Email address of the recipient. Size Range: 1-50

Request Params

Sample 1

Delete a recipient with SubmissionId

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

Sample 2

Delete a recipient with PayeeRef

FormW9/Delete?PayeeRef=Pe123451234

Sample 3

Delete a recipient with Email

FormW9/Delete?Email=steve@abcinc.com

Sample 4

Delete a recipient with SubmissionId [Invalid]

FormW9/Delete?SubmissionId=019c8aec-41fe-4b80-883a-441665dc0033&Email=steve@abcinc.com

Response Body

Field	Type	Description
FormW9Records	Object[]	Details of the W-9s requested to be deleted.
SubmissionId	Guid	A Unique identifier of the submission
PayeeRef	String	A Unique identifier of the recipient
Email	String	Email Address of the recipient.
W9Status	String	Status of the W-9
StatusTs	String	Timestamp of the W-9 Status
Errors	Object[]	Detailed error information.
Id	string	Error ID number. This ID is assigned by TaxBandits and it is unique for each error.
Name	string	Name of the errored node.
Message	string	Shows the error message

Response JSON

Response 1

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

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

Response 2

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

{
   "FormW9Records": [
       {
           "SubmissionId": "58c06235-d278-4d4e-9f0e-cca9d21f38df",
           "PayeeRef": "Pe123451234",
           "Email": "sample@bodeem.com",
           "W9Status": "DELETED",
           "StatusTs": "2021-04-09 13:48:30 -04:00"
       },
       {
           "SubmissionId": "af0835ad-b26c-4a94-8d56-6e8f4cd36cb1",
           "PayeeRef": "Pe123451234",
           "Email": "sample@bodeem.com",
           "W9Status": "DELETED",
           "StatusTs": "2021-04-09 13:48:30 -04:00"
       }
   ],
   "Errors": null
}

Response 3

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

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

Response 4

Since the requester information was not given, the system will look up W-9s under the default business and return the result.

{
   "FormW9Records": null,
   "Errors": [
       {
           "Id": "F00-100146",
           "Name": "Submission Id",
           "Message": "Submission Id is invalid"
       }
   ]
}