Create Tax
POST
/taxesThis endpoint allows you to create a new tax and return the corresponding tax id.
:::caution[Alert]
You must add tax rate and specify which country that tax will be applied to by providing a "country_id"
from the List Countries endpoint
:::
Request
The Tax rate, the percentage at which a tax is levied on a product or transaction, representing the portion of the total amount that must be paid as tax.
A unique identifier associated with a specific country, and it can be set as null or left blank to indicate that the tax rate is intended to apply to all countries. List of countries can be found here.
{
"tax": "15",
"country_id": 773200552
}
Request samples
[api.label.responses]
Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.
Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.
Detailed structure of the tax model object showing its fields and data types.
A unique identification number used for tax purposes, often associated with individuals or businesses.
The percentage at which a specific tax is applied to a given amount.
Tax status indicates an individual or entity's position in relation to tax obligations, exemptions, and filing requirements.
The applicable country for taxation; utilize 'null' values to enforce taxes globally for all countries.
{
"status": 200,
"success": true,
"data": {
"id": 2087347200,
"tax": 5,
"status": "active",
"country": "Bahrain"
}
}