Get complete tax types catalog
Retrieves the complete catalog of available tax types with structured information for tax configuration in Spain: - **Tax regimes**: VAT (Peninsula), IGIC (Canary Islands), IPSI (Ceuta/Melilla), OTHERS - **Percentages per regime**: Valid percentages for each tax type - **Regime codes**: VeriFactu codes for each tax type - **IRPF**: Available withholding percentages - **Equivalence surcharge**: Automatic mappings based on VAT percentage - **Utilities**: Validation functions and geographic auto-detection This endpoint provides all necessary information for the frontend without duplicating tax validation logic.
API Key authentication.
Format: X-API-Key: beel_sk_<key>
Obtaining Keys: API Keys are managed from the BeeL dashboard
Security: API Keys are secret credentials. Do not share them or store them in source code
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://app.beel.es/api/v1/configuracion/tipos-impuestos"{
"success": true,
"data": {
"regimenes_fiscales": [
{
"codigo": "IVA",
"nombre": "IVA",
"descripcion": "Impuesto sobre el Valor Añadido",
"tipos_impuestos": [
{
"porcentaje": 21,
"descripcion": "IVA (21%)",
"activo": true,
"recargo_equivalencia_asociado": 5.2
}
],
"aplica_recargo_equivalencia": true,
"claves_regimen": [
{
"codigo": "01",
"descripcion": "Operación de régimen general"
}
]
}
],
"tipos_irpf": [
{
"porcentaje": 15,
"descripcion": "IRPF Profesional (15%)",
"activo": true
}
],
"recargos_equivalencia": [
{
"porcentaje": 5.2,
"iva_asociado": 21,
"descripcion": "RE 5.2% (IVA 21%)",
"activo": true
}
]
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "123e4567-e89b-12d3-a456-426614174000"
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "123e4567-e89b-12d3-a456-426614174000"
}
}{
"success": false,
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "123e4567-e89b-12d3-a456-426614174000"
}
}