> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.redpincompany.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.redpincompany.com/_mcp/server.

# Property transaction fees

> Calculate property transaction fees across multiple countries

> **Info**
>
> This API provides accurate, up-to-date calculations of property transaction costs, converted to your preferred currency.

The Property Transaction Fees API enables you to calculate the total cost of purchasing properties across multiple countries. Beyond the listed price, property purchases involve various taxes, duties, and legal fees that differ by location, property value, and buyer status.

#### Supported Countries

* Australia
* Spain
* Italy (coming soon)
* Portugal (coming soon)

For detailed API specifications including request parameters, response structure, and examples, please refer to the [API Reference](/api-reference/affiliates/calculate-property-fees).

## Country-Specific Information

Each country has unique property transaction fees and requirements. Understanding these differences is crucial for accurately estimating property costs.

#### Australia

#### Fee Structure

* **Stamp Duty:** Varies by state, typically 4-7% of property value
* **Transfer Duty:** Administrative fee for property title transfer
* **Foreign Acquirer Duty:** Additional tax for foreign buyers, typically 7-8%
* **Application Fee (FIRB):** Foreign Investment Review Board application fee
* **Legal/Conveyancing:** Estimated legal costs for property transfer

> **Warning**
>
> Property state is mandatory for Australian calculations.

#### Spain

#### Fee Structure

* **Property Transfer Tax (ITP):** Varies by autonomous community, typically 6-10%
* **VAT (IVA):** 10% for new properties (instead of Transfer Tax)
* **Stamp Duty (AJD):** 0.5-1.5% depending on the region
* **Notary and Registry Fees:** Approximately 1-2.5% combined

> **Warning**
>
> Property state (autonomous community) is required for Spain calculations.

#### Italy

#### Fee Structure

* **Registration Tax:** 2% for main residences, 9% for non-residents
* **Cadastral Tax:** Fixed fee plus percentage depending on property type
* **Mortgage Tax:** Applicable when financing is involved
* **Notary Fees:** Typically 2-3% of property value

#### Portugal

#### Fee Structure

* **IMT (Property Transfer Tax):** Progressive rate from 0-8% depending on value
* **Stamp Duty:** Fixed at 0.8% of purchase price
* **Registration Fees:** Fixed administrative fees

## Implementation Best Practices

> **Info**
>
> Currency rates fluctuate frequently - don't cache for more than 60 minutes.

### Integration Tips

* Display fee breakdown clearly to help users understand costs
* Consider showing both local currency and buyer's currency
* Indicate when rates are approximate or subject to change

#### Implement API authentication

Set up your API key and configure secure server-to-server communication.

#### Add property input form

Create a form that collects property country, value, and buyer information.

#### Make API request

Send the collected information to the Property Transaction Fees API.

#### Display fee breakdown

Present the returned fee structure in a clear, organized format.

## Error Handling

For a complete list of status codes and error responses, please refer to the [API Reference](/api-reference/affiliates/calculate-property-fees).

Common error scenarios to handle in your implementation:

#### Missing Required Fields

When property_state is not provided for countries that require it (Australia and Spain), the API will return a 400 error with the MISSING_STATE error code.

**Solution:** Always include property_state for Australia and Spain.

#### Currency Conversion Issues

If an unsupported currency is requested or if there's an issue with currency conversion, you may receive a CURRENCY_NOT_SUPPORTED error.

**Solution:** Check the list of supported currencies in the API Reference.