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: Authorization: Bearer beel_sk_<key>
Scopes: API Keys use the same scopes as OAuth2 tokens. Each key is created with
specific scopes that limit which endpoints it can access. The required scope for each
endpoint is documented in the operation's security section under OAuth2.
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/configuration/tax-types"{
"success": true,
"data": {
"tax_regimes": [
{
"code": "IVA",
"name": "IVA",
"description": "Value Added Tax",
"tax_rates": [
{
"percentage": 21,
"description": "IVA (21%)",
"active": true,
"associated_equivalence_surcharge": 5.2
}
],
"applies_equivalence_surcharge": true,
"regime_keys": [
{
"code": "01",
"description": "General regime operation"
}
]
}
],
"irpf_types": [
{
"percentage": 15,
"description": "IRPF Profesional (15%)",
"active": true
}
],
"equivalence_surcharges": [
{
"percentage": 5.2,
"associated_vat": 21,
"description": "RE 5.2% (IVA 21%)",
"active": true
}
],
"exemption_reasons": [
{
"code": "EXENTA_ART_20",
"label": "invoice.exemption.EXENTA_ART_20",
"description": "invoice.exemption.EXENTA_ART_20",
"category": "OPERACIONES EXENTAS",
"classification_type": "EXENTA"
}
]
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}{
"success": false,
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}