Get your Tenancy Deposit Scheme deposits through an API

What you can build on TDS

• Get protected deposits

  Build this

  Reads the deposits held under your TDS Custodial member account, each with its deposit reference, registration date, property and amount.

  Takes

  Branch (optional), registered since (optional)

  Returns

  Deposit reference, registration date, property address, lead tenant, landlord, amount, paid or not, status

• Check repayment requests and disputes

  Build this

  Reads the deposits with a repayment request at the end of the tenancy: the proposed split, the deductions, whether the tenant has replied and any dispute decision.

  Takes

  Deposit reference (optional)

  Returns

  Deposit reference, property address, requested date, proposed split, deductions, tenant response, dispute status, decision published

• Check a deposit by certificate code

  Build this

  Enters a certificate code on the Is My Deposit Protected page, which checks both TDS schemes without signing in.

  Takes

  Certificate code

  Returns

  Certificate code, protected or not, scheme

• Raise a repayment request

  Build this

  Raises a repayment request for one Custodial deposit at the end of the tenancy, with the proposed split and each deduction itemised.

  Takes

  Deposit reference, amount to landlord, amount to tenant, each deduction and its amount

  Returns

  Deposit reference, requested date, proposed split, deductions

Automate TDS with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• Registered deposits still waiting for payment

  Build this

  Starts

  Every weekday at 8:00, London time

  Step 1

  Get the protected deposits registered in the last 30 days.

  Step 2

  Keep the deposits that TDS has not yet received the money for.

  Step 3

  Email you the list with each deposit's reference, registration date, property and amount.

• Newly published dispute decisions

  Build this

  Starts

  Every weekday at 9:00, London time

  Step 1

  Check repayment requests and disputes for every deposit with a dispute.

  Step 2

  Keep the decisions that were not published on the last run.

  Step 3

  Post each one, with the deposit reference, property and split, to your CRM or Slack webhook.

• Weekly list of repayment requests the tenant has not accepted

  Build this

  Starts

  Every Monday at 7:30, London time

  Step 1

  Check repayment requests and disputes across your Custodial deposits.

  Step 2

  Keep the requests the tenant has not accepted yet.

  Step 3

  Email you the list, oldest request first.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get protected deposits” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "custodial.tenancydepositscheme.com/get_protected_deposits",
    "input": {
      "registered_since": "2026-10-13"
    }
  }'

{
  "status": "completed",
  "data": {
    "deposits": [
      {
        "deposit_reference": "EW7350142",
        "registration_date": "2026-11-06",
        "property_address": "14 Northwind Court, Leeds LS6 2AB",
        "lead_tenant": "Alex Morgan",
        "landlord": "Acme Lettings Ltd",
        "amount": 1150,
        "currency": "GBP",
        "paid": false,
        "status": "registered"
      }
    ],
    "count": 1
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

TDS’s own options

TDS offers an API for its own customers on both the Custodial and Insured schemes, used through lettings software and CRMs: TDS has more than 70 integrations in place. You ask TDS's API team, or your software provider, to set it up. The member area is where you manage deposits by hand, and anyone can check a certificate code without signing in.

Read on November 12, 2026: Integrate with our API, Login help, Street.co.uk integrates with TDS Custodial.

Signing in to TDS

TDS signs members in with a username and password on its Login page, and the system sends you to the right scheme. A new Custodial account must be activated with its activation code first, and NRLA landlords sign in through the NRLA website. With Fous you sign in once through TDS's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in.

Worth knowing

Two schemes, two kinds of reference

Custodial deposits, held by TDS, have references like EW1234567. Insured deposits, held by the landlord or agent, have codes like uh7sbj8gk. A method works on the scheme your account belongs to.

Registering a deposit is not paying it

You still pay the deposit to TDS separately. A deposit that is registered but never paid is removed by TDS after 30 days.

The tenant must accept every repayment

Funds are released only after the tenant accepts the repayment request through TDS, even when the full amount goes to the tenant. A disputed request is handled by TDS.

Accounts by branch, England and Wales only

Your Member ID and Branch ID are shown in the TDS portal, and an agency can have one TDS account per branch. TDS Custodial covers properties in England or Wales only.

More in Real estate: property management and listings

• レインズ
• HomeWiseDocs
• Bright MLS
• CRMLS
• Flexmls
• Matrix
• Paragon MLS
• Ignite
• PF Expert
• Rightmove Plus
• ZooplaPro
• AppFolio Property Manager
• Buildium
• Entrata
• PropertyMe
• Yardi Voyager
• Rental Bonds Online
• RTBA Online
• ShowingTime
• Deposit Protection Service

Other industries: FoodLogiQ Connect, Kroger Partner Pass, REWE Group Supplier Portal, Cisco Commerce Workspace, Bunnings PowerPass, OpenInvoice.