# UK Stamp Duty (SDLT) Calculator (`landlordtools/uk-stamp-duty-sdlt`) Actor

Stamp Duty Land Tax for one purchase in England or Northern Ireland, band by band, with first-time buyer relief and the additional-property and non-UK resident surcharges. See README for limits.

- **URL**: https://apify.com/landlordtools/uk-stamp-duty-sdlt.md
- **Developed by:** [LandlordTools](https://apify.com/landlordtools) (community)
- **Categories:** Real estate, Business
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 sdlt calculations

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## UK Stamp Duty (SDLT) Calculator

Work out Stamp Duty Land Tax for one purchase of land or property in England or Northern Ireland. Give a price, an effective date and the buyer's circumstances; get the total tax, the effective rate and the tax in each band, with the rates period used and GOV.UK sources. One JSON result goes to the dataset and to the key-value store's `OUTPUT` record.

**Not tax advice.** This Actor estimates SDLT from published rate tables. Check the figure with HMRC's own calculator, or a conveyancer, before you file a return.

### What it covers

- **Residential rates** by effective date: the rates from 1 April 2025 [1], and the earlier periods from 23 September 2022 [2], [3].
- **First-time buyer relief**: 0% up to the nil-rate threshold and 5% up to the maximum price, with no relief above the maximum [1], [2].
- **Higher rates for additional dwellings**: 3 percentage points before 31 October 2024 and 5 points from that date, on purchases of £40,000 or more [3], [4].
- **Non-UK resident surcharge**: 2 percentage points on top of all other residential rates, on purchases of £40,000 or more [5].
- **Non-residential and mixed-use rates** [6].

### Input

```json
{
  "price": 300000,
  "effectiveDate": "2026-06-30",
  "propertyType": "residential",
  "additionalProperty": true
}
```

- `price`: required, whole pounds from 1 to 1,000,000,000.
- `effectiveDate`: required, `YYYY-MM-DD`, on or after 2022-09-23. Usually the completion date.
- `propertyType`: `residential` (default) or `nonResidential` (non-residential or mixed use).
- `firstTimeBuyer`, `additionalProperty`, `nonUkResident`: optional booleans, residential only. A first-time buyer cannot also be buying an additional property.

Unknown fields are rejected. Do not include names or addresses.

### Example output

Selected fields for the input above:

```json
{
  "ratesUsed": "residential",
  "ratesPeriod": {
    "from": "2025-04-01",
    "to": null
  },
  "surchargePercentagePoints": 5,
  "tax": 20000,
  "effectiveRate": 6.67
}
```

The full result also lists each band (`from`, `to`, `rate`, `taxable`, `tax`), notes and source URLs. See `examples/output.json`.

### Limits

One purchase per run, by individuals. Not modelled: leases with rent (net present value), linked transactions, purchases by companies, multiple purchases, and reliefs other than first-time buyer relief. Scotland (LBTT) and Wales (LTT) have their own taxes and are not covered.

If contracts were exchanged before 31 October 2024 but completion was on or after that date, the additional-dwellings surcharge stays at 3% [3]. Set `pre31Oct2024ContractRelief: true` only if that transitional relief has been independently confirmed; otherwise the dated surcharge applies. The Actor does not assess contract variations, assignments or other transitional conditions. Contracts on or before 25 November 2015 are outside scope [3].

**Rates must be checked after every Budget.** They live in `rates.json` with the date last checked; an effective date after that date adds a warning to `notes`. Band calculations retain pennies; the final tax is rounded down to whole pounds [7].

### Batch input

Send `{"items": [ ... ]}` with up to 1,000 inputs, each shaped like the single input above, to get one dataset row per item, each with its `index`. A bad item gives a row with `error` instead of failing the run. This suits AI agents (every Apify Actor is also an MCP tool) and bulk users.

### Integrations

Ready-made files in [`integrations/`](integrations/README.md): a **Microsoft Power Platform custom connector** (Power Automate, Power Apps, Logic Apps, Copilot Studio), **OpenAPI 3** (Azure API Management, Postman, n8n, AI agents), an **Excel / Power BI Power Query** script, a **Google Sheets** function, and curl, Python and JavaScript examples. Apify's own Zapier, Make and n8n apps and its MCP server work too.

### Pricing

Pay per event: one event per successful calculation. Suggested price: $3 per 1,000 calculations.

### Local use

With Node.js 22 or later, run `node cli.js examples/input.json`, or `npm test` for the worked examples, Actor checks across five time zones and this README check.

### Sources

1. [GOV.UK: Stamp Duty Land Tax, residential property rates](https://www.gov.uk/stamp-duty-land-tax/residential-property-rates). Accessed 3 October 2026.
2. [GOV.UK: Stamp Duty Land Tax rates, 23 September 2022 to 30 October 2024](https://www.gov.uk/government/publications/rates-and-allowances-stamp-duty-land-tax/stamp-duty-land-tax-rates-23-september-2022-to-30-october-2024). Accessed 3 October 2026.
3. [GOV.UK: Stamp Duty Land Tax rates, 31 October 2024 to 31 March 2025](https://www.gov.uk/government/publications/rates-and-allowances-stamp-duty-land-tax/stamp-duty-land-tax-rates-31-october-2024-to-31-march-2025). Accessed 3 October 2026.
4. [GOV.UK: Higher rates of Stamp Duty Land Tax (additional residential property)](https://www.gov.uk/guidance/stamp-duty-land-tax-buying-an-additional-residential-property). Accessed 3 October 2026.
5. [GOV.UK: Rates of Stamp Duty Land Tax for non-UK residents](https://www.gov.uk/guidance/rates-of-stamp-duty-land-tax-for-non-uk-residents). Accessed 3 October 2026.
6. [GOV.UK: Stamp Duty Land Tax, rates for non-residential and mixed land and property](https://www.gov.uk/stamp-duty-land-tax/nonresidential-and-mixed-rates). Accessed 3 October 2026.

[1]: https://www.gov.uk/stamp-duty-land-tax/residential-property-rates

[2]: https://www.gov.uk/government/publications/rates-and-allowances-stamp-duty-land-tax/stamp-duty-land-tax-rates-23-september-2022-to-30-october-2024

[3]: https://www.gov.uk/government/publications/rates-and-allowances-stamp-duty-land-tax/stamp-duty-land-tax-rates-31-october-2024-to-31-march-2025

[4]: https://www.gov.uk/guidance/stamp-duty-land-tax-buying-an-additional-residential-property

[5]: https://www.gov.uk/guidance/rates-of-stamp-duty-land-tax-for-non-uk-residents

[6]: https://www.gov.uk/stamp-duty-land-tax/nonresidential-and-mixed-rates

7. [GOV.UK: SDLT calculations and rounding](https://www.gov.uk/guidance/sdlt-linked-purchases-or-transfers). Accessed 3 October 2026.

[7]: https://www.gov.uk/guidance/sdlt-linked-purchases-or-transfers

AI-generated software draft; manager review required before release.

# Actor input Schema

## `price` (type: `integer`):

Whole pounds, from 1 to 1000000000.

## `effectiveDate` (type: `string`):

YYYY-MM-DD, on or after 2022-09-23. The date decides which rates apply.

## `propertyType` (type: `string`):

residential, or nonResidential for non-residential and mixed-use property.

## `firstTimeBuyer` (type: `boolean`):

Every buyer is a first-time buyer buying their main residence. Residential only.

## `additionalProperty` (type: `boolean`):

After buying, a buyer will own more than one residential property (for example a buy-to-let). Residential only.

## `nonUkResident` (type: `boolean`):

One or more buyers is non-UK resident for SDLT. Residential only.

## `items` (type: `array`):

Instead of the fields above, a list of 1 to 1000 objects, each with those fields (required in each: price, effectiveDate). One dataset row per item; a bad item gives an error row.

## `pre31Oct2024ContractRelief` (type: `boolean`):

True only after confirming eligibility for the pre-31 October 2024 contract transitional 3% surcharge. See README.

## Actor input object example

```json
{
  "price": 300000,
  "effectiveDate": "2026-06-30",
  "propertyType": "residential",
  "firstTimeBuyer": false,
  "additionalProperty": false,
  "nonUkResident": false,
  "pre31Oct2024ContractRelief": false
}
```

# Actor output Schema

## `result` (type: `string`):

No description

## `output` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "price": 300000,
    "effectiveDate": "2026-06-30",
    "propertyType": "residential",
    "firstTimeBuyer": false,
    "additionalProperty": false,
    "nonUkResident": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("landlordtools/uk-stamp-duty-sdlt").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "price": 300000,
    "effectiveDate": "2026-06-30",
    "propertyType": "residential",
    "firstTimeBuyer": False,
    "additionalProperty": False,
    "nonUkResident": False,
}

# Run the Actor and wait for it to finish
run = client.actor("landlordtools/uk-stamp-duty-sdlt").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "price": 300000,
  "effectiveDate": "2026-06-30",
  "propertyType": "residential",
  "firstTimeBuyer": false,
  "additionalProperty": false,
  "nonUkResident": false
}' |
apify call landlordtools/uk-stamp-duty-sdlt --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,landlordtools/uk-stamp-duty-sdlt"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/0cEAqSbIb8KVeQ996/builds/TZXeMf7LZjATuP9Hb/openapi.json