TaxRate

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/checkoutpage-com/json-schema/checkoutpage-com-tax-rate-schema.json",
  "title": "TaxRate",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/checkoutpage-com-tax-rates-api-openapi.yml#/components/schemas/TaxRate",
  "properties": {
    "createdAt": {
      "format": "date-time",
      "type": "string"
    },
    "default": {
      "description": "Whether this is the default tax rate for the seller.",
      "type": "boolean"
    },
    "displayName": {
      "description": "Short name describing the type of tax, for example VAT, GST, or Sales Tax. Displayed in the checkout and invoices. Maximum 50 characters.",
      "type": "string"
    },
    "id": {
      "allOf": [
        {
          "$ref": "#/$defs/UniqueIdentifier"
        },
        {
          "description": "Unique identifier for the tax rate."
        }
      ]
    },
    "inclusive": {
      "description": "Specifies whether the tax behaviour is inclusive (`true`) or exclusive (`false`).",
      "type": "boolean"
    },
    "percentage": {
      "description": "Tax rate percentage out of 100.",
      "maximum": 100,
      "minimum": 0,
      "type": "number"
    },
    "sellerId": {
      "description": "Unique identifier for the seller that owns this tax rate.",
      "type": "string"
    },
    "stripeId": {
      "description": "The corresponding Stripe Tax Rate ID on the merchant's Stripe account.",
      "type": "string"
    },
    "updatedAt": {
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "id",
    "sellerId",
    "stripeId",
    "displayName",
    "inclusive",
    "percentage",
    "default",
    "createdAt",
    "updatedAt"
  ],
  "type": "object",
  "$defs": {
    "UniqueIdentifier": {
      "description": "Unique identifier for the ticket.",
      "pattern": "^[0-9a-fA-F]{24}$",
      "type": "string"
    }
  }
}