# Turn the Deposit Protection Service into an API

> Read your DPS notifications, tenancy statuses and repayments, or register a new tenancy, with one API call each. A workflow can check Your Notifications each morning and email you every evidence or Statutory Declaration deadline.

Page: https://fous.com/automate/deposit-protection-service
Updated: 2026-11-12

Works with your own Deposit Protection Service account. Fous is an independent product.

## What you can build on the DPS

### Get the actions due on your dashboard

Reads Your Notifications on the account dashboard: each category that needs action, with the tenancy address and the deadline date where one applies.

- Takes: Nothing
- Returns: Category, property address, deadline date, days left

### Get tenancies by status

Reads View tenancies for the tenancies in one status, such as Awaiting deposit payment or Repayment request in progress.

- Takes: Status
- Returns: Deposit ID, property address, tenants, deposit amount, status

### Get the Repayments report

Runs the Repayments report from the Reports tab and returns its rows: repayments, pending ones included, with deposit IDs, due dates and status.

- Takes: From date, to date
- Returns: Deposit ID, property address, amount, due date, status

### Register a new Custodial tenancy

Creates a new tenancy in the Custodial account with the rent, deposit amount and tenants' contact details, ready for the deposit to be paid.

- Takes: Property address, start date, rent amount, deposit amount, tenants' names and contact details
- Returns: Deposit ID, property address, deposit amount, status

## Automate the DPS with a workflow

A [workflow](/product/workflows) 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.

### Evidence and response deadlines, every morning

Starts: Every weekday at 8:00

1. Get the actions due in Your Notifications on the dashboard.
2. Keep the items with a deadline date, and those not there on the last run.
3. Email you the list, soonest deadline first, with category and property address.

### Tenancies still awaiting deposit payment

Starts: Every Monday at 7:00

1. Get the tenancies in the status Awaiting deposit payment.
2. Stop when there are none.
3. Email you each one with its deposit ID, property address, tenants and deposit amount.

### Repayments posted to your accounting system

Starts: Every weekday at 18:00

1. Get the Repayments report for the last 30 days.
2. Keep the rows that are new or changed since the last run.
3. Post deposit ID, property address, amount, due date and status to your accounting webhook.

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](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get the actions due on your dashboard” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "portal.depositprotection.com/get_dashboard_actions",
    "input": {}
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "notifications": [
      {
        "category": "Evidence required",
        "property_address": "14 Northwind Road, Bristol, BS3 1AA",
        "deadline_date": "2026-11-17",
        "days_left": 5
      }
    ],
    "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.

## The DPS’s own options

The DPS has an API that creates tenancies in your account from lettings CRM software it is integrated with, such as Goodlord, PayProp and Apex27; you request an API key from the DPS by email and still pay deposits in your account. Several tenancies can also be sent in one spreadsheet, and the Reports tab downloads CSV reports. Everything else happens in the online account.

| Option | What it covers | What it takes |
| --- | --- | --- |
| DPS API through your CRM | Creates the tenancy in your DPS account from tenancy details already entered in integrated CRM software. You then log in and pay the deposit. | One of the integrated products (10Ninety, Acquaint, Apex27, AgentOS, Estates IT, Flatfair, GNB, Goodlord, PayProp, SME, Yorlet) and an API key from the DPS. |
| Multiple Tenancy Upload tool | A spreadsheet with one row per tenancy. The DPS creates the tenancies and sends back deposit values and a payment reference. | The completed spreadsheet sent by email to the DPS, then a bank transfer quoting the payment reference. |
| Reports tab | Balance held on the selected date, Payments, All tenancies, Activity log and Repayments, downloaded as CSV. | A DPS account. Each report is run by hand with its criteria. |
| The DPS account by hand | Dashboard, View tenancies, Manage tenancy, repayments, claims, evidence and transfers, one tenancy at a time. | A free Custodial account, or a separate Insured account with validation and a fee per tenancy. |

Read on November 12, 2026: [Protecting deposits](https://www.depositprotection.com/how-to-use-our-service/protecting-deposits), [New reporting suite](https://www.depositprotection.com/news-insights/new-reporting-suite), [During the tenancy](https://www.depositprotection.com/how-to-use-our-service/during-tenancy/).

## Signing in to the DPS

The DPS signs landlords and letting agents in with an email address and password at portal.depositprotection.com, and the Insured scheme has its own login and account. An account can have account owner and administrator users. With Fous you sign in once through the DPS'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

- **Custodial and Insured are separate accounts**: An Insured account is separate from a Custodial one, has its own login and needs validation documents first. A method works in the account it was built on, so build one per scheme if you use both.
- **30 days for protection and Prescribed Information**: A deposit has to be protected and Prescribed Information given to the tenant within 30 days of receiving it, or a penalty of one to three times the deposit can apply. For Custodial deposits the DPS creates it, to download from the tenancy.
- **Evidence has a 14-day window**: In a dispute you have 14 calendar days from the DPS's email to submit evidence, up to 40MB per upload and 1,000 characters of extra information. Files can be deleted only before you submit.
- **Tenancy details are not edited online**: To correct a tenancy you send a signed copy of the original tenancy agreement. Only the rent amount, start date, length of tenancy and tenant names can be changed.

## More in Real estate: property management and listings

- [レインズ](https://fous.com/automate/reins.md)
- [HomeWiseDocs](https://fous.com/automate/homewisedocs.md)
- [Bright MLS](https://fous.com/automate/bright-mls.md)
- [CRMLS](https://fous.com/automate/crmls.md)
- [Flexmls](https://fous.com/automate/flexmls.md)
- [Matrix](https://fous.com/automate/matrix.md)
- [Paragon MLS](https://fous.com/automate/paragon-mls.md)
- [Ignite](https://fous.com/automate/ignite.md)
- [PF Expert](https://fous.com/automate/pf-expert.md)
- [Rightmove Plus](https://fous.com/automate/rightmove-plus.md)
- [ZooplaPro](https://fous.com/automate/zooplapro.md)
- [AppFolio Property Manager](https://fous.com/automate/appfolio-property-manager.md)
- [Buildium](https://fous.com/automate/buildium.md)
- [Entrata](https://fous.com/automate/entrata.md)
- [PropertyMe](https://fous.com/automate/propertyme.md)
- [Yardi Voyager](https://fous.com/automate/yardi-voyager.md)
- [Rental Bonds Online](https://fous.com/automate/rental-bonds-online.md)
- [RTBA Online](https://fous.com/automate/rtba-online.md)
- [ShowingTime](https://fous.com/automate/showingtime.md)
- [Tenancy Deposit Scheme](https://fous.com/automate/tenancy-deposit-scheme.md)

Other industries: [NLIS database](/automate/nlis-database), [Home Depot Supplier Hub](/automate/home-depot-supplier-hub), [Morrisons Supplier Portal](/automate/morrisons-supplier-portal), [TD SYNNEX ECExpress](/automate/td-synnex-ecexpress), [Enphase Installer Platform](/automate/enphase-installer-platform), [Taulia supplier portal](/automate/taulia-supplier-portal).

## Frequently asked questions

### Does the Deposit Protection Service have an API?

Yes, through lettings software it is integrated with, such as Goodlord, PayProp, Apex27 or 10Ninety. The API creates tenancies from your CRM; you request a key from the DPS and pay the deposit in your account. Without one of those products you use the account itself, the Multiple Tenancy Upload spreadsheet and the CSV reports.

### How quickly is a deposit repaid when the tenant agrees?

Within two business days. When you choose Return full deposit or Make a claim, the DPS contacts the tenant, and pays the deposit as requested once they agree. If they disagree, the DPS contacts you about next steps and the free Dispute Resolution Service.

### What if the tenant does not respond to a repayment request?

After 14 days without a response, or if the other party cannot be contacted, you can start the Statutory Declaration process from your online account. Your Notifications on the dashboard has a Statutory Declaration response required category, with a deadline date where one applies.

### Can I export a list of all my deposits?

Yes, from the Reports tab, as CSV. The reports are Balance held on the selected date, Payments, All tenancies, Activity log and Repayments. With Fous, a method you build can read a report's rows, and a workflow can send them on a schedule by email or webhook.

### Is Fous affiliated with The Deposit Protection Service?

No. Fous is an independent product. You use it with your own DPS account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Deposit Protection Service (The Deposit Protection Service (Computershare Investor Services Plc)). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.