# Get your MyHMCTS case progress through an API

> Read the state of each case in your MyHMCTS Case list, its Case Progress and its Event history with one API call each. Or have a workflow check your probate cases every morning and email you the ones that moved to Case stopped or Grant issued.

Page: https://fous.com/automate/myhmcts
Updated: 2026-11-12

Works with your own MyHMCTS account. Fous is an independent product.

## What you can build on MyHMCTS

### Find cases by state

Uses Find case on the Case list in Manage cases to search one jurisdiction by case state, or Any state, and returns each case with its state.

- Takes: Jurisdiction, state (optional)
- Returns: Case number, state

### Read a case's progress and event history

Opens one case by its case number and reads Case Progress, with each step and whether it shows Completed, and the Event history tab with the case worker.

- Takes: Case number
- Returns: Case number, state, progress steps with status, events with date and time, case worker

### Find cases not assigned to any users

Reads Cases in Manage organisation with the filter Cases not assigned to any users and lists each case it shows.

- Takes: Nothing
- Returns: Case number, number of unassigned cases

### Share a case with a colleague

Selects a case in Manage organisation, uses Share Case to add a colleague from your organisation, and confirms the change.

- Takes: Case number, colleague
- Returns: Case number, colleague, confirmed

## Automate MyHMCTS 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.

### Probate cases that changed state, every morning

Starts: Every weekday at 8:00

1. Find your probate cases with Any state on the Case list.
2. Keep the cases whose state changed since the last run, such as Case stopped or Grant issued.
3. For each one, read its progress and Event history and email you the case, its new state and the case worker.

### Unassigned cases, checked every Monday

Starts: Every Monday at 9:00

1. Find the cases not assigned to any users in Manage organisation.
2. Stop when there are none.
3. Email you the list of case numbers and the total.

### Cases awaiting documentation, posted to your case system

Starts: Every weekday at 16:00

1. Find the probate cases in the state Awaiting documentation on the Case list.
2. Keep the cases that were not in that state on the last run.
3. Post each case number and state to your case management system's 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 “Find cases by state” 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": "manage-case.platform.hmcts.net/find_cases_by_state",
    "input": {
      "jurisdiction": "Probate",
      "state": "Any"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "jurisdiction": "Probate",
    "state_filter": "Any",
    "cases": [
      {
        "case_number": "1700-0000-0000-0001",
        "state": "Awaiting documentation"
      }
    ],
    "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.

## MyHMCTS’s own options

HMCTS's guidance for MyHMCTS describes the service in the browser and no API for firms. Cases are created, progressed and checked in Manage cases, and users, case access and fee accounts in Manage organisation. Payment by Account statements arrive weekly by email, and an XML version can be requested.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Payment by Account (PBA) statements | Weekly Advance Notice invoices, itemised with each case fee and reference number. An XML version can be requested. | A free PBA number, applied for from the Liberata PBA Support Team with the Fee Account Customer Application Form. |
| MyHMCTS by hand | The Case list, each case's tabs and next steps in Manage cases, and users and case sharing in Manage organisation. | A registered organisation account and a named user account, in Google Chrome or Microsoft Edge. |

Read on November 12, 2026: [Register for MyHMCTS: online case management for professionals](https://www.gov.uk/guidance/myhmcts-online-case-management-for-legal-professionals), [HMCTS Payment by Account for online services](https://www.gov.uk/guidance/hmcts-payment-by-account-for-online-services).

## Signing in to MyHMCTS

MyHMCTS signs each user in to their own account, and every sign-in sends a verification code by email that stays valid for 90 minutes. The organisation's administrator must be a named person, not a team or shared address. With Fous you sign in once through MyHMCTS's own sign-in with your own account: the login is sealed with AES-256, the emailed code is handled, and an expired session is signed back in.

## Worth knowing

- **Cases and users live at two addresses**: Cases live in Manage cases at manage-case.platform.hmcts.net. Users, case sharing and fee accounts live in Manage organisation at manage-org.platform.hmcts.net.
- **A damages claim has no draft**: You cannot save a damages claim before submitting it, and it is issued only once the issue fee is paid from the Service Request tab. You then have 4 months to notify the claim details to the defendant.
- **A grant goes out within 48 hours**: Once a probate case reaches Grant issued, the grant is dispatched within 48 hours. A workflow that watches for Grant issued tells you a grant is on its way.
- **Suspending a user is immediate**: Suspension takes effect at once, so the user's cases should be shared or reassigned first. To fix a name or email address, HMCTS asks you to re-invite the person instead.

## More in Legal, courts and intellectual property

- [Portal Informacyjny Sądów Powszechnych](https://fous.com/automate/portal-informacyjny-sadow-powszechnych.md)
- [eCourts e-Filing](https://fous.com/automate/ecourts-e-filing.md)
- [Money Claim Online](https://fous.com/automate/money-claim-online.md)
- [PACER](https://fous.com/automate/pacer.md)
- [Authorized Paid Representative Portal](https://fous.com/automate/authorized-paid-representative-portal.md)
- [Arbitration Forums](https://fous.com/automate/arbitration-forums.md)
- [CCMS](https://fous.com/automate/ccms.md)
- [CounselLink](https://fous.com/automate/counsellink.md)
- [Legal Tracker](https://fous.com/automate/legal-tracker.md)
- [TyMetrix 360](https://fous.com/automate/tymetrix-360.md)
- [Collaborati](https://fous.com/automate/collaborati.md)
- [MyEPO Portfolio](https://fous.com/automate/myepo-portfolio.md)

Other industries: [Air France KLM Martinair Cargo myCargo](/automate/air-france-klm-martinair-cargo-mycargo), [NetX360+](/automate/netx360), [PayCargo](/automate/paycargo), [Navisphere Carrier](/automate/navisphere-carrier), [RTX Supply Chain Platform](/automate/rtx-supply-chain-platform), [CAMP MTX](/automate/camp-mtx).

## Frequently asked questions

### Does MyHMCTS have an API?

Not one that HMCTS describes for firms. Its guidance covers the service in the browser: Manage cases for the cases and Manage organisation for users, case sharing and fee accounts. Payment by Account statements arrive weekly by email, with an XML version on request.

### How do I see where a probate application has got to?

Find the case in the Case list and open it. Case Progress shows the steps, Event history shows when each was completed and who the case worker is, and the state moves through Case created, Awaiting documentation, Ready to issue and Grant issued, or shows Case stopped.

### How do I find cases nobody in my firm is assigned to?

In Manage organisation, open Cases, select Show cases filter, choose Cases not assigned to any users and select Apply filter. You can then share each case with a colleague using Share Case.

### Why has my MyHMCTS verification code not arrived?

Codes come by email from hm.courts.and.tribunals.registrations@notifications.service.gov.uk, so check your junk folder. A code is valid for 90 minutes. If none has arrived after 20 minutes, HMCTS asks you to contact MyHMCTS support.

### Is Fous affiliated with HM Courts & Tribunals Service?

No. Fous is an independent product. You use it with your own MyHMCTS 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 MyHMCTS (HM Courts & Tribunals Service). 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.
