Tax

Calculate product price including tax

Return an indicative price for an offer including the tax that applies to a customer in the given country. Intended for storefront display (e.g. showing gross prices on a product page). The result is a **quote**, not a settled charge: the authoritative tax is always recomputed at checkout from full billing details. Amounts are returned in the smallest currency unit (e.g. 1099 = 10.99 in a 2-decimal currency). For business (B2B) buyers, pass customerType=company with taxId + taxNumber. The quote always returns the standard destination rate; if the buyer is eligible for reverse charge, reverseChargeEligible is true, but the 0% rate is only applied at checkout once the VAT-ID is validated.

Authorization

Public key
x-fngs-public-key<token>

In: header

Request Body

application/json

POST /v0/tax/calculate Request body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

POST
/v0/tax/calculate
curl -X POST "https://example.com/v0/tax/calculate" \  -H "Content-Type: application/json" \  -d '{    "offerId": "42da58f8-9040-4cf5-98ce-bce9965cca0d",    "country": "AF"  }'
{  "status": "success",  "data": {    "object": "tax_calculation",    "offerId": "42da58f8-9040-4cf5-98ce-bce9965cca0d",    "quantity": -9007199254740991,    "currency": "AFN",    "customerType": "individual",    "taxBehavior": "exclusive",    "amountSubtotal": -1.7976931348623157e+308,    "amountTax": -1.7976931348623157e+308,    "amountTotal": -1.7976931348623157e+308,    "reverseChargeEligible": true,    "taxBreakdown": [      {        "taxType": null,        "country": null,        "state": null,        "percentage": null,        "amount": -1.7976931348623157e+308,        "inclusive": true      }    ]  }}