Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

BatchDeleteTaxRegistration

Deletes tax registration for multiple accounts in batch. This can be used to delete tax registrations for up to five accounts in one batch.

Note

This API operation can't be used to delete your tax registration in Brazil. Use the Payment preferences page in the AWS Billing and Cost Management console instead.

Request Syntax


POST /BatchDeleteTaxRegistration HTTP/1.1
Content-type: application/json

{
   "accountIds": [ "string" ]
}

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.

accountIds

List of unique account identifiers.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 5 items.

Length Constraints: Fixed length of 12.

Pattern: ^\d+$

Required: Yes

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "errors": [ 
      { 
         "accountId": "string",
         "code": "string",
         "message": "string"
      }
   ]
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

errors

The list of errors for the accounts the TRN information could not be deleted for.

Type: Array of BatchDeleteTaxRegistrationError objects

Errors

For information about the errors that are common to all actions, see Common Errors.

ConflictException

The exception when the input is creating conflict with the given state.

HTTP Status Code: 409

InternalServerException

The exception thrown when an unexpected error occurs when processing a request.

HTTP Status Code: 500

ValidationException

The exception when the input doesn't pass validation for at least one of the input parameters.

HTTP Status Code: 400