Amazon Web Services, Inc.

Tax Settings

You can use the tax setting API to programmatically set, modify, and delete the tax registration number (TRN), associated business legal name, and address…

Developer tools#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

You can use the tax setting API to programmatically set, modify, and delete the tax registration number (TRN), associated business legal name, and address (Collectively referred to as "TRN information"). You can also programmatically view TRN information and tax addresses ("Tax profiles"). You can use this API to automate your TRN information settings instead of manually using the console. Service Endpoint https://tax.us-east-1.amazonaws.com

Endpoints 16

  • POSTBatch delete tax registration/BatchDeleteTaxRegistrationDeletes tax registration for multiple accounts in batch. This can be used to delete tax registrations for up to five accounts in one batch. This API operation…
  • POSTBatch get tax exemptions/BatchGetTaxExemptionsGet the active tax exemptions for a given list of accounts. The IAM action is tax:GetExemptions .
  • POSTBatch put tax registration/BatchPutTaxRegistrationAdds or updates tax registration for multiple accounts in batch. This can be used to add or update tax registrations for up to five accounts in one batch. You…
  • POSTDelete supplemental tax registration/DeleteSupplementalTaxRegistrationDeletes a supplemental tax registration for a single account.
  • POSTDelete tax registration/DeleteTaxRegistrationDeletes tax registration for a single account. This API operation can't be used to delete your tax registration in Brazil. Use the Payment preferences page in…
  • POSTGet tax exemption types/GetTaxExemptionTypesGet supported tax exemption types. The IAM action is tax:GetExemptions .
  • POSTGet tax inheritance/GetTaxInheritanceThe get account tax inheritance status.
  • POSTGet tax registration/GetTaxRegistrationRetrieves tax registration for a single account.
  • POSTGet tax registration document/GetTaxRegistrationDocumentDownloads your tax documents to the Amazon S3 bucket that you specify in your request.
  • POSTList supplemental tax registrations/ListSupplementalTaxRegistrationsRetrieves supplemental tax registrations for a single account.
  • POSTList tax exemptions/ListTaxExemptionsRetrieves the tax exemption of accounts listed in a consolidated billing family. The IAM action is tax:GetExemptions .
  • POSTList tax registrations/ListTaxRegistrationsRetrieves the tax registration of accounts listed in a consolidated billing family. This can be used to retrieve up to 100 accounts' tax registrations in one…
  • POSTPut supplemental tax registration/PutSupplementalTaxRegistrationStores supplemental tax registration for a single account.
  • POSTPut tax exemption/PutTaxExemptionAdds the tax exemption for a single account or all accounts listed in a consolidated billing family. The IAM action is tax:UpdateExemptions .
  • POSTPut tax inheritance/PutTaxInheritanceThe updated tax inheritance status.
  • POSTPut tax registration/PutTaxRegistrationAdds or updates tax registration for a single account. You can't set a TRN if there's a pending TRN. You'll need to delete the pending TRN first. To call this…

API details

Base URL
https://tax.{region}.amazonaws.com
Authentication
AWS Signature Version 4 (requests signed with your AWS access key)
Operations
16 operations on 16 pathsPOST 16
Description format
AWS Smithy model, API version 2018-05-10

How to test the Tax Settings in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Tax Settings collection, without the publisher's secrets.
  3. Add your credentialsThis API uses AWS Signature Version 4 (requests signed with your AWS access key). Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Batch delete tax registration” (POST /BatchDeleteTaxRegistration), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Tax Settings?

You can use the tax setting API to programmatically set, modify, and delete the tax registration number (TRN), associated business legal name, and address… It is listed under Developer tools and has 16 endpoints.

Who publishes the Tax Settings?

It is listed from Amazon Web Services, Inc.'s public API description (an OpenAPI document), not published by Amazon Web Services, Inc. on Swastik Codes. Anyone who controls amazonaws.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Tax Settings?

Requests go to https://tax.{region}.amazonaws.com. Endpoint paths are added to this base URL.

How do I authenticate with the Tax Settings?

With AWS Signature Version 4 (requests signed with your AWS access key).

How many endpoints does the Tax Settings have?

16 operations on 16 paths (16 POST).

Is forking the Tax Settings free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.