getSalesTaxes

v1.0.0

Use this call to retrieve all sales tax table entries that the seller has defined for a specific country. All four response fields will be returned for each tax jurisdiction that matches the search criteria.

Important! In most US states and territories, eBay now 'collects and remits' sales tax, so sellers can no longer configure sales tax rates for these states/territories.

Input

{
  "type": "object",
  "properties": {
    "country_code": {
      "type": "string"
    }
  },
  "required": [
    "country_code"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "description": "This type is used by the root response of the <b>getSalesTaxes</b> method.",
  "properties": {
    "salesTaxes": {
      "type": "array",
      "description": "An array of one or more sales tax rate entries for a specific marketplace (or all applicable marketplaces if the <b>country_code</b> query parameter is not used.<br><br>If no sales tax rate entries are set up, no response payload is returned, but only an HTTP status code of <code>204 No Content</code>.",
      "items": {
        "type": "object",
        "description": "This type is used to provide sales tax settings for a specific tax jurisdiction.",
        "properties": {
          "countryCode": {
            "type": "string",
            "description": "The country code enumeration value identifies the country to which this sales tax rate applies. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/account/types/ba:CountryCodeEnum'>eBay API documentation</a>"
          },
          "salesTaxJurisdictionId": {
            "type": "string",
            "description": "A unique ID that identifies the sales tax jurisdiction to which the sales tax rate applies (for example, a state within the United States)."
          },
          "salesTaxPercentage": {
            "type": "string",
            "description": "The sales tax rate that will be applied to sales price. The <b>shippingAndHandlingTaxed</b> value will indicate whether or not sales tax is also applied to shipping and handling charges<br><br>Although it is a string, a percentage value is returned here, such as <code>7.75</code>"
          },
          "shippingAndHandlingTaxed": {
            "type": "boolean",
            "description": "If returned as <code>true</code>, sales tax is also applied to shipping and handling charges, and not just the total sales price of the order."
          }
        }
      }
    }
  }
}