This doc page has moved! You should be automatically redirected to the resources page for the eBay Account API. If you are not redirected automatically, follow this link to the Account API.

eBay Account APIVersion 1.2.0

Get a Sales Tax Table

GET /sales_tax

Use this call to retrieve a sales tax table that the seller established for a specific country. Specify the tax table to retrieve using the country_code query parameter.

Input

See also Samples.

Resource URI (production)

GET https://api.ebay.com/sell/account/v1/sales_tax?
  country_code=CountryCodeEnum

URI parameters

Parameter Type Required? Meaning
country_code string Required A two-letter ISO 3166-1 Alpha-2.

Applicable values are from CountryCodeEnum.


HTTP request headers

All requests made to eBay REST operations require you to provide the authorization HTTP header for authentication.
See HTTP request headers for details.



OAuth request scope

This request requires a user access token with the following scope:

https://api.ebay.com/oauth/api_scope/sell.account

https://api.ebay.com/oauth/api_scope/sell.account.readonly

See Getting Access Tokens for more information.



Payload model

This call has no request payload.


Output

See also Samples.

HTTP status codes

This call can return one of the following HTTP status codes. See the HTTP Status Code Registry for a complete overview of HTTP status codes.

Status Meaning
200 Success
400 Bad Request
500 Internal Server Error

Payload model

Note: For information about the error fields and how to work with them, see Error Handling.

The following lists all fields that could be included in the response.

{ /* SalesTaxes */
"salesTaxes": [
    { /* SalesTax */
    "countryCode": string,
    "salesTaxJurisdictionId": string,
    "salesTaxPercentage": string,
    "shippingAndHandlingTaxed": boolean
    }
    /* More SalesTax nodes here */
  ]
}

Response field descriptions



Output Container/Field Type Occurrence Meaning
salesTaxes array of SalesTax Conditionally A list of sales tax tables that have been set up by a seller.
salesTaxes.countryCode string Conditionally The country code identifying the country to which this tax rate applies.

Applicable values are from CountryCodeEnum:See countryCode.
Code so that your app gracefully handles any future changes to this list.
salesTaxes
  .salesTaxJurisdictionId
string Conditionally A unique ID that identifies the sales tax jurisdiction to which the tax rate applies (for example a state within the United States).
salesTaxes.salesTaxPercentage string Conditionally The sales tax rate (as a percentage of the sale) applied to sales transactions made in this country and sales tax jurisdiction.
salesTaxes
  .shippingAndHandlingTaxed
boolean Conditionally Set this value to true to indicate that shipping and handling charges are taxed.



Error Codes

Code Domain Category Nature Meaning
20400 API_ACCOUNT REQUEST ERROR Invalid request. {additionalInfo}
20401 API_ACCOUNT REQUEST ERROR Missing field {fieldName}. {additionalInfo}
20403 API_ACCOUNT REQUEST ERROR Invalid {fieldName}. {additionalInfo}
20500 API_ACCOUNT APPLICATION ERROR System error.



Samples

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Sample: Get the sales tax table for a country

This call retrieves the sales tax table for a specified country.

Description

This call gets all the sales tax table entries that the seller has configured for the specified country's tax jurisdictions.

Input

Supply the two-letter country code in the country_code query parameter to indicate the country whose tax table you want to retrieve.

URL format. See also the non-wrapped version of this URL.

GET https://api.sandbox.ebay.com/sell/account/v1/sales_tax?
   country_code=US

Output

This example call returns the sales tax entries that have been set up for the United States (US). The seller must have previously configured the sale-tax table, otherwise the response will contain an empty list.

JSON format.
{
  "salesTaxes": [
    {
      "salesTaxPercentage": "3.75",
      "shippingAndHandlingTaxed": false,
      "countryCode": "US",
      "salesTaxJurisdictionId": "IL"
    },
    {
      "salesTaxPercentage": "4.0",
      "shippingAndHandlingTaxed": true,
      "countryCode": "US",
      "salesTaxJurisdictionId": "NY"
    }
  ]
}



Change History

Change Date Description
1.0.0
2016-10-19
  • Call (added): New call.