ConfigurationTax

Get complete tax types catalog

Deprecated. Use GET /v1/tax-types, which returns exactly the same catalog. It is reference data shared by every account, not the settings of a NIF, so it does not belong under /v1/configuration.

Returns the catalog of Spanish tax regimes with their valid percentages and VeriFactu regime codes.

  • tax_regimes: the tax types and the percentages and regime keys each one admits.
  • irpf_types: the available IRPF withholding rates.
  • equivalence_surcharges: the surcharge that corresponds to each VAT percentage.
  • exemption_reasons: the accepted exemption reasons.

Retires on 9 December 2026. See the migration guide for what moved where and what changes when you switch.

get/v1/configuration/tax-types

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/configuration/tax-types
  • Auth: HTTP bearer

Response

Catalog retrieved successfully

successboolean required

Example response

{
  "success": true,
  "data": {
    "tax_regimes": [
      {
        "code": "IVA",
        "name": "IVA",
        "description": "Value Added Tax",
        "tax_rates": [
          {
            "percentage": 21,
            "description": "IVA (21%)",
            "associated_equivalence_surcharge": 5.2
          }
        ],
        "regime_keys": [
          {
            "code": "01",
            "description": "General regime operation"
          }
        ]
      }
    ],
    "irpf_types": [
      {
        "percentage": 15,
        "description": "IRPF Profesional (15%)"
      }
    ],
    "equivalence_surcharges": [
      {
        "percentage": 5.2,
        "associated_vat": 21,
        "description": "RE 5.2% (IVA 21%)"
      }
    ],
    "exemption_reasons": [
      {
        "code": "EXENTA_ART_20",
        "label": "invoice.exemption.EXENTA_ART_20",
        "description": "invoice.exemption.EXENTA_ART_20",
        "category": "OPERACIONES EXENTAS",
        "available_on_invoice_line": true
      }
    ]
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Changes

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