ConfigurationTax

Get user tax configuration

Deprecated. Use GET /v1/companies/{company_id}/tax-configuration, which behaves identically.

Retrieves the tax configuration of the company in focus: the default main tax (IVA, IGIC, IPSI or OTHER) with its percentage and regime key, the default exemption reason, the IRPF and equivalence surcharge settings, and the default payment method and payment term.

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

get/v1/configuration/taxes

Request

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

Response

Configuration retrieved successfully

successboolean required

Example response

{
  "success": true,
  "data": {
    "default_main_tax": {
      "type": "IVA",
      "percentage": 21,
      "regime_key": "01"
    },
    "default_exemption_reason": "EXENTA_ART_20",
    "default_equivalence_surcharge": 5.2,
    "default_irpf_rate": 15,
    "default_payment_method": "BANK_TRANSFER",
    "withholding_options": {
      "allowed_irpf_rates": [
        0,
        19,
        24
      ]
    }
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Changes

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