> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fungies.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 tax-inclusive 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).

    This endpoint prices business-to-consumer (B2C) sales. B2B reverse-charge determination
    is deliberately out of scope and is resolved at checkout.



## OpenAPI

````yaml /api-reference/api-docs.yaml post /v0/tax/calculate
openapi: 3.1.0
info:
  title: Fungies API v0
  version: 0.3.5
servers:
  - url: https://api.fungies.io
security: []
tags:
  - name: discounts
    description: Discounts related endpoints
  - name: keys
    description: Offer product keys related endpoints
  - name: orders
    description: Orders related endpoints
  - name: payments
    description: Payments related endpoints
  - name: offers
    description: Offers related endpoints
  - name: products
    description: Products related endpoints
  - name: subscriptions
    description: Subscriptions related endpoints
  - name: tax
    description: Tax calculation related endpoints
  - name: users
    description: Users related endpoints
  - name: variants
    description: Product variants related endpoints
  - name: plans
    description: Product plans related endpoints
  - name: elements
    description: Elements related endpoints
paths:
  /v0/tax/calculate:
    post:
      tags:
        - tax
      summary: Calculate product price including tax
      description: >-
        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 tax-inclusive 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).

            This endpoint prices business-to-consumer (B2C) sales. B2B reverse-charge determination
            is deliberately out of scope and is resolved at checkout.
      operationId: PostV0TaxCalculate
      requestBody:
        description: POST /v0/tax/calculate Request body
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV0TaxCalculateRequestBody'
      responses:
        '200':
          description: POST /v0/tax/calculate Positive response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV0TaxCalculatePositiveResponse'
        '400':
          description: POST /v0/tax/calculate Negative response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV0TaxCalculateNegativeResponse'
              examples:
                example1:
                  value:
                    status: error
                    error:
                      message: Sample error message
      security:
        - APIKEY_1: []
components:
  schemas:
    PostV0TaxCalculateRequestBody:
      type: object
      properties:
        offerId:
          type: string
          format: uuid
        quantity:
          type: integer
          format: int64
          exclusiveMinimum: 0
          maximum: 1000
          default: 1
        country:
          type: string
          enum:
            - AF
            - AX
            - AL
            - DZ
            - AD
            - AO
            - AI
            - AQ
            - AG
            - AR
            - AM
            - AW
            - AU
            - AT
            - AZ
            - BS
            - BH
            - BD
            - BB
            - BY
            - BE
            - BZ
            - BJ
            - BM
            - BT
            - BO
            - BA
            - BW
            - BV
            - BR
            - IO
            - VG
            - BN
            - BG
            - BF
            - BI
            - KH
            - CM
            - CA
            - CV
            - BQ
            - KY
            - CF
            - TD
            - CL
            - CN
            - CO
            - KM
            - CG
            - CD
            - CK
            - CR
            - CI
            - HR
            - CW
            - CY
            - CZ
            - DK
            - DJ
            - DM
            - DO
            - EC
            - EG
            - SV
            - GQ
            - ER
            - EE
            - SZ
            - ET
            - FK
            - FO
            - FJ
            - FI
            - FR
            - GF
            - PF
            - TF
            - GA
            - GM
            - GE
            - DE
            - GH
            - GI
            - GR
            - GL
            - GD
            - GP
            - GU
            - GT
            - GG
            - GN
            - GW
            - GY
            - HT
            - HN
            - HK
            - HU
            - IS
            - IN
            - ID
            - IQ
            - IE
            - IM
            - IL
            - IT
            - JM
            - JP
            - JE
            - JO
            - KZ
            - KE
            - KI
            - XK
            - KW
            - KG
            - LA
            - LV
            - LB
            - LS
            - LR
            - LY
            - LI
            - LT
            - LU
            - MO
            - MG
            - MW
            - MY
            - MV
            - ML
            - MT
            - MQ
            - MR
            - MU
            - YT
            - MX
            - MD
            - MC
            - MN
            - ME
            - MS
            - MA
            - MZ
            - MM
            - NA
            - NR
            - NP
            - NL
            - NC
            - NZ
            - NI
            - NE
            - NG
            - NU
            - MK
            - 'NO'
            - OM
            - PK
            - PS
            - PA
            - PG
            - PY
            - PE
            - PH
            - PN
            - PL
            - PT
            - PR
            - QA
            - RE
            - RO
            - RU
            - RW
            - WS
            - SM
            - ST
            - SA
            - SN
            - RS
            - SC
            - SL
            - SG
            - SX
            - SK
            - SI
            - SB
            - SO
            - ZA
            - GS
            - KR
            - SS
            - ES
            - LK
            - BL
            - SH
            - KN
            - LC
            - MF
            - PM
            - VC
            - SD
            - SR
            - SJ
            - SE
            - CH
            - TW
            - TJ
            - TZ
            - TH
            - TL
            - TG
            - TK
            - TO
            - TT
            - TN
            - TR
            - TM
            - TC
            - TV
            - UG
            - UA
            - AE
            - GB
            - US
            - UY
            - UZ
            - VU
            - VA
            - VE
            - VN
            - WF
            - EH
            - YE
            - ZM
            - ZW
        state:
          type: string
          maxLength: 10
        postalCode:
          type: string
          maxLength: 20
      required:
        - offerId
        - country
    PostV0TaxCalculatePositiveResponse:
      type: object
      properties:
        status:
          type: string
          const: success
        data:
          type: object
          properties:
            object:
              type: string
              enum:
                - tax_calculation
              default: tax_calculation
            offerId:
              type: string
              format: uuid
            quantity:
              type: integer
              format: int64
              minimum: -9007199254740991
              maximum: 9007199254740991
            currency:
              type: string
              enum:
                - AFN
                - ALL
                - DZD
                - AOA
                - ARS
                - AMD
                - AWG
                - AUD
                - AZN
                - BSD
                - BDT
                - BBD
                - BZD
                - BMD
                - BOB
                - BAM
                - BWP
                - BRL
                - BHD
                - GBP
                - BND
                - BGN
                - BIF
                - BYN
                - KHR
                - CAD
                - CVE
                - KYD
                - KWD
                - XAF
                - XPF
                - CLP
                - CNY
                - COP
                - KMF
                - CDF
                - CRC
                - HRK
                - CZK
                - DKK
                - DJF
                - DOP
                - XCD
                - EGP
                - ETB
                - EUR
                - FKP
                - FJD
                - GMD
                - GEL
                - GIP
                - GTQ
                - GNF
                - GYD
                - HTG
                - HNL
                - HKD
                - HUF
                - ISK
                - INR
                - IDR
                - ILS
                - JMD
                - JPY
                - JOD
                - KZT
                - KES
                - KGS
                - LAK
                - LBP
                - LSL
                - LRD
                - MOP
                - MKD
                - MGA
                - MWK
                - MYR
                - MVR
                - MRO
                - MUR
                - MXN
                - MDL
                - MNT
                - MAD
                - MZN
                - MMK
                - NAD
                - NPR
                - ANG
                - TWD
                - NZD
                - NIO
                - NGN
                - NOK
                - OMR
                - PKR
                - PAB
                - PGK
                - PYG
                - PEN
                - PHP
                - PLN
                - QAR
                - RON
                - RUB
                - RWF
                - SHP
                - SVC
                - WST
                - STD
                - SAR
                - RSD
                - SCR
                - SLL
                - SGD
                - SBD
                - SOS
                - ZAR
                - KRW
                - LKR
                - SRD
                - SZL
                - SEK
                - CHF
                - TJS
                - TZS
                - THB
                - TND
                - TOP
                - TTD
                - TRY
                - UGX
                - UAH
                - AED
                - UYU
                - USD
                - UZS
                - VUV
                - VEF
                - VND
                - XOF
                - YER
                - ZMW
                - SLE
                - XCG
                - SSP
                - VES
                - MRU
                - STN
                - VED
            taxBehavior:
              type: string
              enum:
                - exclusive
                - inclusive
            amountSubtotal:
              type: number
              format: double
              minimum: -1.7976931348623157e+308
              maximum: 1.7976931348623157e+308
            amountTax:
              type: number
              format: double
              minimum: -1.7976931348623157e+308
              maximum: 1.7976931348623157e+308
            amountTotal:
              type: number
              format: double
              minimum: -1.7976931348623157e+308
              maximum: 1.7976931348623157e+308
            taxBreakdown:
              type: array
              items:
                type: object
                properties:
                  taxType:
                    type:
                      - string
                      - 'null'
                    default: null
                  country:
                    type:
                      - string
                      - 'null'
                    default: null
                  state:
                    type:
                      - string
                      - 'null'
                    default: null
                  percentage:
                    type:
                      - string
                      - 'null'
                    default: null
                  amount:
                    type: number
                    format: double
                    minimum: -1.7976931348623157e+308
                    maximum: 1.7976931348623157e+308
                  inclusive:
                    type: boolean
                required:
                  - amount
                  - inclusive
          required:
            - offerId
            - quantity
            - currency
            - taxBehavior
            - amountSubtotal
            - amountTax
            - amountTotal
            - taxBreakdown
      required:
        - status
        - data
    PostV0TaxCalculateNegativeResponse:
      type: object
      properties:
        status:
          type: string
          const: error
        error:
          type: object
          properties:
            message:
              type: string
          required:
            - message
      required:
        - status
        - error
  securitySchemes:
    APIKEY_1:
      type: apiKey
      in: header
      name: x-fngs-public-key

````