Taxes

Retrieve the tax catalog

Return the Spanish tax catalog in one document: IVA/IGIC/IPSI regimes and rates, operation regimes, exemption causes, IRPF withholding rates and legal VAT/surcharge pairs.

  • No company data or custom taxes (see GET /v1/companies/{company}/taxes); withholding rates are POSITIVE.
  • Labels in es/en/ca; cacheable via ETag (304 on If-None-Match).
get/tax-catalog

Request

  • Base URL: https://api.factuarea.com/v1
  • URL: https://api.factuarea.com/v1/tax-catalog
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Headers

Factuarea-Versionstring date
Example:2026-06-01

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Response

Example response

{
  "data": {
    "primary_language": "es",
    "indirect_tax_regimes": [
      {
        "code": "iva",
        "aeat_code": "01",
        "valid_rates": [
          0,
          4,
          10,
          21
        ],
        "general_rate": 21,
        "aeat_zones": [
          "peninsula"
        ],
        "label": {
          "es": "Régimen general",
          "en": "General regime",
          "ca": "Règim general"
        }
      }
    ],
    "operation_regimes": [
      {
        "code": "intracomunitaria",
        "legal_mention": "Operación intracomunitaria sujeta y exenta - Art. 25 LIVA",
        "requires_zero_vat": true,
        "label": {
          "es": "Régimen general",
          "en": "General regime",
          "ca": "Règim general"
        },
        "description": {
          "es": "Régimen general",
          "en": "General regime",
          "ca": "Règim general"
        }
      }
    ],
    "exemption_causes": [
      {
        "code": "exenta_art_25",
        "causa_exencion": "E5",
        "legal_mention": "Operación intracomunitaria sujeta y exenta conforme al artículo 25 de la Ley 37/1992.",
        "article": "Art. 25 LIVA",
        "line_level": true,
        "label": {
          "es": "Régimen general",
          "en": "General regime",
          "ca": "Règim general"
        },
        "description": {
          "es": "Régimen general",
          "en": "General regime",
          "ca": "Règim general"
        }
      }
    ],
    "retention_rates": [
      {
        "code": "IRPF_15",
        "rate": 15,
        "applies_to": "sale",
        "label": {
          "es": "Régimen general",
          "en": "General regime",
          "ca": "Règim general"
        }
      }
    ],
    "equivalence_surcharge_pairs": [
      {
        "vat": 21,
        "surcharge": 5.2,
        "label": {
          "es": "Régimen general",
          "en": "General regime",
          "ca": "Règim general"
        }
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.