Jumpseller Taxes API
The Taxes API from Jumpseller — 3 operation(s) for taxes.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/jumpseller-com:jumpseller-com-taxes-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Jumpseller Com Taxes API
version: 1.0.0
x-logo:
url: https://api.jumpseller.com/images/jumpseller-logo-full.svg
altText: Jumpseller logo
href: /
description: 'Operations tagged Taxes across 2 of this provider''s published API definitions: jumpseller-com-openapi-openapi.json, jumpseller-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.jumpseller.com/v1
tags:
- name: Taxes
paths:
/taxes.json:
get:
tags:
- Taxes
summary: Retrieve all Taxes
security:
- BasicAuthentication:
- taxes
- loginParameter: []
authtokenParameter: []
- OAuth2:
- read_taxes
parameters: []
responses:
'200':
description: An array of Taxes
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Tax'
x-codeSamples:
- lang: Shell
label: cURL
source: curl -u XXXXX:YYYYY -X GET "https://api.jumpseller.com/v1/taxes.json"
- lang: PHP
label: PHP
source: '<?php
$login = ''XXXXX'';
$authtoken = ''YYYYY'';
$url = ''https://api.jumpseller.com/v1/taxes.json'';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, $login . '':'' . $authtoken);
curl_setopt($ch, CURLOPT_HTTPHEADER, [''Content-Type: application/json'']);
$response = curl_exec($ch);
curl_close($ch);
echo $response;'
- lang: Ruby
label: Ruby
source: 'require ''net/http''
require ''json''
uri = URI(''https://api.jumpseller.com/v1/taxes.json'')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request.basic_auth(''XXXXX'', ''YYYYY'')
request[''Content-Type''] = ''application/json''
response = http.request(request)
puts JSON.parse(response.body)'
- lang: Python
label: Python
source: "import requests\n\nresponse = requests.get(\n 'https://api.jumpseller.com/v1/taxes.json',\n auth=('XXXXX', 'YYYYY')\n)\nprint(response.json())"
- lang: JavaScript
label: JavaScript
source: "const response = await fetch('https://api.jumpseller.com/v1/taxes.json', {\n method: 'GET',\n headers: {\n 'Authorization': 'Basic ' + btoa('XXXXX:YYYYY'),\n 'Content-Type': 'application/json'\n }\n});\n\nconst data = await response.json();\nconsole.log(data);"
operationId: getTaxesJson
x-operation-id-source: derived
post:
tags:
- Taxes
summary: Create a new Tax
security:
- BasicAuthentication:
- taxes
- loginParameter: []
authtokenParameter: []
- OAuth2:
- write_taxes
parameters: []
requestBody:
description: Tax parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/TaxEdit'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/Tax'
'404':
description: Tax Not Found.
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
x-codegen-request-body-name: body
x-codeSamples:
- lang: Shell
label: cURL
source: "curl -u XXXXX:YYYYY -X POST \"https://api.jumpseller.com/v1/taxes.json\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"tax\": {\"country\": \"US\", \"name\": \"My Example\", \"region\": \"example\", \"category_id\": 123, \"tax\": 1.0}}'"
- lang: PHP
label: PHP
source: '<?php
$login = ''XXXXX'';
$authtoken = ''YYYYY'';
$url = ''https://api.jumpseller.com/v1/taxes.json'';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, $login . '':'' . $authtoken);
curl_setopt($ch, CURLOPT_HTTPHEADER, [''Content-Type: application/json'']);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, ''POST'');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([''tax'' => [''country'' => ''US'', ''name'' => ''My Example'', ''region'' => ''example'', ''category_id'' => 123, ''tax'' => 1.0]]));
$response = curl_exec($ch);
curl_close($ch);
echo $response;'
- lang: Ruby
label: Ruby
source: 'require ''net/http''
require ''json''
uri = URI(''https://api.jumpseller.com/v1/taxes.json'')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request.basic_auth(''XXXXX'', ''YYYYY'')
request[''Content-Type''] = ''application/json''
request.body = { tax: { country: ''US'', name: ''My Example'', region: ''example'', category_id: 123, tax: 1.0 } }.to_json
response = http.request(request)
puts JSON.parse(response.body)'
- lang: Python
label: Python
source: "import requests\n\nresponse = requests.post(\n 'https://api.jumpseller.com/v1/taxes.json',\n auth=('XXXXX', 'YYYYY'),\n json={'tax': {'country': 'US', 'name': 'My Example', 'region': 'example', 'category_id': 123, 'tax': 1.0}}\n)\nprint(response.json())"
- lang: JavaScript
label: JavaScript
source: "const response = await fetch('https://api.jumpseller.com/v1/taxes.json', {\n method: 'POST',\n headers: {\n 'Authorization': 'Basic ' + btoa('XXXXX:YYYYY'),\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify({\"tax\": {\"country\": \"US\", \"name\": \"My Example\", \"region\": \"example\", \"category_id\": 123, \"tax\": 1.0}})\n});\n\nconst data = await response.json();\nconsole.log(data);"
operationId: postTaxesJson
x-operation-id-source: derived
servers:
- url: https://api.jumpseller.com/v1
/taxes/{id}.json:
get:
tags:
- Taxes
summary: Retrieve a single Tax information
security:
- BasicAuthentication:
- taxes
- loginParameter: []
authtokenParameter: []
- OAuth2:
- read_taxes
parameters:
- name: id
in: path
description: Id of the Tax
required: true
schema:
type: integer
format: int32
responses:
'200':
description: A Tax information object
content:
application/json:
schema:
$ref: '#/components/schemas/Tax'
'404':
description: Tax Not Found.
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
x-codeSamples:
- lang: Shell
label: cURL
source: curl -u XXXXX:YYYYY -X GET "https://api.jumpseller.com/v1/taxes/123.json"
- lang: PHP
label: PHP
source: '<?php
$login = ''XXXXX'';
$authtoken = ''YYYYY'';
$url = ''https://api.jumpseller.com/v1/taxes/123.json'';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, $login . '':'' . $authtoken);
curl_setopt($ch, CURLOPT_HTTPHEADER, [''Content-Type: application/json'']);
$response = curl_exec($ch);
curl_close($ch);
echo $response;'
- lang: Ruby
label: Ruby
source: 'require ''net/http''
require ''json''
uri = URI(''https://api.jumpseller.com/v1/taxes/123.json'')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request.basic_auth(''XXXXX'', ''YYYYY'')
request[''Content-Type''] = ''application/json''
response = http.request(request)
puts JSON.parse(response.body)'
- lang: Python
label: Python
source: "import requests\n\nresponse = requests.get(\n 'https://api.jumpseller.com/v1/taxes/123.json',\n auth=('XXXXX', 'YYYYY')\n)\nprint(response.json())"
- lang: JavaScript
label: JavaScript
source: "const response = await fetch('https://api.jumpseller.com/v1/taxes/123.json', {\n method: 'GET',\n headers: {\n 'Authorization': 'Basic ' + btoa('XXXXX:YYYYY'),\n 'Content-Type': 'application/json'\n }\n});\n\nconst data = await response.json();\nconsole.log(data);"
operationId: getTaxes{id}Json
x-operation-id-source: derived
put:
tags:
- Taxes
summary: Modify an existing Tax
security:
- BasicAuthentication:
- taxes
- loginParameter: []
authtokenParameter: []
- OAuth2:
- write_taxes
parameters:
- name: id
in: path
description: Id of the Tax
required: true
schema:
type: integer
format: int32
requestBody:
description: Tax parameters to change.
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TaxEdit'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/Tax'
'404':
description: Tax Not Found, or it could not be saved (validation error or invalid category).
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
x-codegen-request-body-name: body
x-codeSamples:
- lang: Shell
label: cURL
source: "curl -u XXXXX:YYYYY -X PUT \"https://api.jumpseller.com/v1/taxes/123.json\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"tax\": {\"name\": \"VAT\", \"tax\": 23.0}}'"
- lang: PHP
label: PHP
source: '<?php
$login = ''XXXXX'';
$authtoken = ''YYYYY'';
$url = ''https://api.jumpseller.com/v1/taxes/123.json'';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, $login . '':'' . $authtoken);
curl_setopt($ch, CURLOPT_HTTPHEADER, [''Content-Type: application/json'']);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, ''PUT'');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([''tax'' => [''name'' => ''VAT'', ''tax'' => 23.0]]));
$response = curl_exec($ch);
curl_close($ch);
echo $response;'
- lang: Ruby
label: Ruby
source: 'require ''net/http''
require ''json''
uri = URI(''https://api.jumpseller.com/v1/taxes/123.json'')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Put.new(uri)
request.basic_auth(''XXXXX'', ''YYYYY'')
request[''Content-Type''] = ''application/json''
request.body = { tax: { name: ''VAT'', tax: 23.0 } }.to_json
response = http.request(request)
puts JSON.parse(response.body)'
- lang: Python
label: Python
source: "import requests\n\nresponse = requests.put(\n 'https://api.jumpseller.com/v1/taxes/123.json',\n auth=('XXXXX', 'YYYYY'),\n json={'tax': {'name': 'VAT', 'tax': 23.0}}\n)\nprint(response.json())"
- lang: JavaScript
label: JavaScript
source: "const response = await fetch('https://api.jumpseller.com/v1/taxes/123.json', {\n method: 'PUT',\n headers: {\n 'Authorization': 'Basic ' + btoa('XXXXX:YYYYY'),\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify({\"tax\": {\"name\": \"VAT\", \"tax\": 23.0}})\n});\n\nconst data = await response.json();\nconsole.log(data);"
operationId: putTaxes{id}Json
x-operation-id-source: derived
delete:
tags:
- Taxes
summary: Delete an existing Tax
security:
- BasicAuthentication:
- taxes
- loginParameter: []
authtokenParameter: []
- OAuth2:
- write_taxes
parameters:
- name: id
in: path
description: Id of the Tax
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/MessageObject'
'404':
description: Tax Not Found, or it could not be deleted.
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
x-codeSamples:
- lang: Shell
label: cURL
source: curl -u XXXXX:YYYYY -X DELETE "https://api.jumpseller.com/v1/taxes/123.json"
- lang: PHP
label: PHP
source: '<?php
$login = ''XXXXX'';
$authtoken = ''YYYYY'';
$url = ''https://api.jumpseller.com/v1/taxes/123.json'';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, $login . '':'' . $authtoken);
curl_setopt($ch, CURLOPT_HTTPHEADER, [''Content-Type: application/json'']);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, ''DELETE'');
$response = curl_exec($ch);
curl_close($ch);
echo $response;'
- lang: Ruby
label: Ruby
source: 'require ''net/http''
require ''json''
uri = URI(''https://api.jumpseller.com/v1/taxes/123.json'')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(uri)
request.basic_auth(''XXXXX'', ''YYYYY'')
request[''Content-Type''] = ''application/json''
response = http.request(request)
puts JSON.parse(response.body)'
- lang: Python
label: Python
source: "import requests\n\nresponse = requests.delete(\n 'https://api.jumpseller.com/v1/taxes/123.json',\n auth=('XXXXX', 'YYYYY')\n)\nprint(response.json())"
- lang: JavaScript
label: JavaScript
source: "const response = await fetch('https://api.jumpseller.com/v1/taxes/123.json', {\n method: 'DELETE',\n headers: {\n 'Authorization': 'Basic ' + btoa('XXXXX:YYYYY'),\n 'Content-Type': 'application/json'\n }\n});\n\nconst data = await response.json();\nconsole.log(data);"
operationId: deleteTaxes{id}Json
x-operation-id-source: derived
servers:
- url: https://api.jumpseller.com/v1
/taxes/settings.json:
get:
tags:
- Taxes
summary: Retrieve the Store's tax settings
security:
- BasicAuthentication:
- taxes
- loginParameter: []
authtokenParameter: []
- OAuth2:
- read_taxes
parameters: []
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/TaxSettings'
x-codeSamples:
- lang: Shell
label: cURL
source: curl -u XXXXX:YYYYY -X GET "https://api.jumpseller.com/v1/taxes/settings.json"
- lang: PHP
label: PHP
source: '<?php
$login = ''XXXXX'';
$authtoken = ''YYYYY'';
$url = ''https://api.jumpseller.com/v1/taxes/settings.json'';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, $login . '':'' . $authtoken);
curl_setopt($ch, CURLOPT_HTTPHEADER, [''Content-Type: application/json'']);
$response = curl_exec($ch);
curl_close($ch);
echo $response;'
- lang: Ruby
label: Ruby
source: 'require ''net/http''
require ''json''
uri = URI(''https://api.jumpseller.com/v1/taxes/settings.json'')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request.basic_auth(''XXXXX'', ''YYYYY'')
request[''Content-Type''] = ''application/json''
response = http.request(request)
puts JSON.parse(response.body)'
- lang: Python
label: Python
source: "import requests\n\nresponse = requests.get(\n 'https://api.jumpseller.com/v1/taxes/settings.json',\n auth=('XXXXX', 'YYYYY')\n)\nprint(response.json())"
- lang: JavaScript
label: JavaScript
source: "const response = await fetch('https://api.jumpseller.com/v1/taxes/settings.json', {\n method: 'GET',\n headers: {\n 'Authorization': 'Basic ' + btoa('XXXXX:YYYYY'),\n 'Content-Type': 'application/json'\n }\n});\n\nconst data = await response.json();\nconsole.log(data);"
operationId: getTaxesSettingsJson
x-operation-id-source: derived
servers:
- url: https://api.jumpseller.com/v1
components:
schemas:
TaxEditFields:
type: object
properties:
country:
type: string
description: Country where the Tax applies
name:
type: string
description: Name that identifies tax
region:
type: string
description: Region where the Tax applies
category_id:
type: integer
description: Unique identifier of the category of the Tax
format: int32
tax:
type: number
description: Tax value for the given Tax
format: float
fixed:
type: boolean
description: True if the tax has a fixed valued amount
default: false
shipping:
type: boolean
description: True if the tax should be applied to shipping costs
default: false
Tax:
type: object
properties:
tax:
$ref: '#/components/schemas/TaxFields'
TaxFields:
type: object
properties:
id:
type: integer
description: Unique identifier of the Tax
format: int32
name:
type: string
description: Name that identifies tax
country:
type: string
description: Country name where the Tax applies
region:
type: string
description: Region name where the Tax applies
category_id:
type: integer
description: Unique identifier of the category of the Tax
format: int32
tax_amount:
type: number
description: Tax value for the given Tax
format: float
fixed:
type: boolean
description: True if the tax has a fixed valued amount
default: false
shipping:
type: boolean
description: True if the tax should be applied to shipping costs
default: false
NotFound:
type: object
properties:
message:
type: string
TaxEdit:
type: object
properties:
tax:
$ref: '#/components/schemas/TaxEditFields'
TaxSettings:
type: object
properties:
based_on:
type: string
description: Customer address used to calculate taxes
enum:
- billing
- shipping
tax_on_product_price:
type: boolean
description: True if product prices include taxes
tax_on_shipping_price:
type: boolean
description: True if shipping prices include taxes
tax_exempt_eu_vat:
type: boolean
description: True if EU businesses with a valid VAT number are exempt from taxes
MessageObject:
type: object
properties:
message:
type: string
TaxEditFields_2:
type: object
properties:
country:
type: string
description: Country code (ISO 3166-1 alpha-2) where the Tax applies
name:
type: string
description: Name that identifies tax
region:
type: string
description: Region code where the Tax applies, or `*` for every region
category_id:
type: integer
description: Unique identifier of the category of the Tax
format: int32
tax:
type: number
description: 'Tax value: a percentage, or an amount when `fixed` is true'
format: float
fixed:
type: boolean
description: True if the tax has a fixed valued amount
default: false
shipping:
type: boolean
description: True if the tax should be applied to shipping costs
default: false
product_type:
type:
- string
- 'null'
description: Product type the Tax applies to
enum:
- physical
- digital
- gift_card
- null
kind:
type: string
description: '`tax`, or a fee kind: fees are charged on their own order line apart from the order tax and added to the total. Fees require a `name`.'
enum:
- tax
- deposit
default: tax
municipality:
type: string
description: Municipality code where the Tax applies, or `*` for every municipality
default: '*'
TaxFields_2:
type: object
properties:
id:
type: integer
description: Unique identifier of the Tax
format: int32
name:
type: string
description: Name that identifies tax
country:
type: string
description: Country name where the Tax applies
region:
type: string
description: Region name where the Tax applies
category_id:
type: integer
description: Unique identifier of the category of the Tax
format: int32
tax_amount:
type: number
description: Tax value for the given Tax
format: float
fixed:
type: boolean
description: True if the tax has a fixed valued amount
default: false
shipping:
type: boolean
description: True if the tax should be applied to shipping costs
default: false
product_type:
type:
- string
- 'null'
description: Product type the Tax applies to
enum:
- physical
- digital
- gift_card
- null
kind:
type: string
description: '`tax`, or a fee kind: fees are charged on their own order line apart from the order tax and added to the total. Fees require a `name`.'
enum:
- tax
- deposit
default: tax
securitySchemes:
BasicAuthentication:
type: http
scheme: basic
description: Basic authentication in the format of `login:authtoken` or `partner_code:auth_token`.
loginParameter:
type: apiKey
in: query
name: login
description: API OAuth login. Learn how to get yours [here](#section/Authentication).
authtokenParameter:
type: apiKey
in: query
name: authtoken
description: API OAuth token. Learn how to get yours [here](#section/Authentication).
auth_tokenParameter:
type: apiKey
in: query
name: auth_token
description: Partner authentication token.
OAuth2:
type: oauth2
description: OAuth 2.0 authorization code flow. Register your app at the Jumpseller Admin Panel to get client credentials. See https://jumpseller.com/support/oauth-2/ for details.
flows:
authorizationCode:
authorizationUrl: https://accounts.jumpseller.com/oauth/authorize
tokenUrl: https://accounts.jumpseller.com/oauth/token
refreshUrl: https://accounts.jumpseller.com/oauth/token
scopes:
read_products: Read products, variants, images, options, and custom fields
write_products: Create, update, and delete products
read_orders: Read orders, fulfillments, and order history
write_orders: Create, update, and refund orders
read_customers: Read customer accounts and groups
write_customers: Create, update, and delete customers
read_categories: Read product categories
write_categories: Create, update, and delete categories
read_store: Read store information and settings
write_store: Update store settings
read_settings: Read store configuration
write_settings: Update store configuration
read_shipping_methods: Read shipping methods and rates
write_shipping_methods: Create and update shipping methods
read_payment_methods: Read payment methods
write_payment_methods: Create and update payment methods
read_hooks: Read webhooks
write_hooks: Create, update, and delete webhooks
read_promotions: Read promotions and discounts
write_promotions: Create, update, and delete promotions
read_taxes: Read tax rules
write_taxes: Create and update tax rules
read_pages: Read store pages
write_pages: Create, update, and delete pages
read_countries: Read country information
write_countries: Update country settings
read_custom_fields: Read product custom fields
write_custom_fields: Create and update custom fields
read_checkout_custom_fields: Read checkout additional fields
write_checkout_custom_fields: Update checkout additional fields
read_customer_categories: Read customer categories
write_customer_categories: Create and update customer categories
read_jsapps: Read JavaScript apps
write_jsapps: Create, update, and delete JavaScript apps
read_apps: Read installed apps
read_fulfillments: Read fulfillment information
write_fulfillments: Create and update fulfillments
read_locations: Read warehouse locations
write_locations: Create and update locations
write_reviews: Manage product reviews
read_transaction_ledgers: Read store balance
write_store_setup: Create new stores via the store setup endpoint
x-refined-from:
- jumpseller-com-openapi-openapi.json
- jumpseller-com-openapi.json