# Get your MYS claims and submissions through an API

> Read each pharmacy's service claims, past end of month submissions and referred back and disallowed items from MYS with one API call each. A workflow can email you last month's claims on the 2nd, ready to review before the Pharmacy First deadline.

Page: https://fous.com/automate/nhsbsa-manage-your-service
Updated: 2026-11-12

Works with your own NHSBSA Manage Your Service account. Fous is an independent product.

## What you can build on MYS

### Get the month's service claims

Reads one pharmacy's payment claims for a month, one per service such as Pharmacy First, as MYS has populated them, with each claim's status.

- Takes: ODS code, claim month
- Returns: Service, claim month, number of provisions, claim status, submitted date

### Get referred back and disallowed items

Reads the referred back and disallowed items MYS holds for one pharmacy, with the reason given and where each one stands until it is processed.

- Takes: ODS code, dispensing month (optional)
- Returns: Dispensing month, item, type (referred back or disallowed), reason, status

### List past end of month submissions

Reads the end of month prescription submissions a pharmacy has made in MYS, with the figures entered on each batch submission form.

- Takes: ODS code, from month (optional)
- Returns: Dispensing month, submitted date, submitted by, form figures

### Submit a reviewed service claim

Opens one month's populated payment claim for a service, compares its number of provisions with the one you expect and, if they match, submits it.

- Takes: ODS code, service, claim month, expected number of provisions
- Returns: Service, claim month, number of provisions, claim status, submitted date

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

### Last month's service claims, ready for review

Starts: On the 2nd of every month at 8:00, London time

1. For each ODS code you name, get last month's service claims.
2. Keep the claims that are not yet submitted.
3. Email you the list, one section per pharmacy, so each claim is reviewed before the Pharmacy First deadline on the 5th.

### New referred back and disallowed items, every pharmacy

Starts: Every weekday at 9:00, London time

1. For each ODS code, get the referred back and disallowed items.
2. Keep the items that were not there on the last run.
3. Post each one, with its reason and status, to your webhook.

### Claims still open before the deadline

Starts: On the 4th of every month at 12:00, London time

1. For each ODS code, get last month's service claims.
2. Keep the claims whose status is not submitted, and stop when there are none.
3. Email you the pharmacies and services that still need a claim submitted.

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 month's service claims” 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-your-service-pharmacy.nhsbsa.nhs.uk/get_service_claims",
    "input": {
      "ods_code": "FZX41",
      "claim_month": "2026-10"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "ods_code": "FZX41",
    "pharmacy": "Northwind Pharmacy",
    "claim_month": "2026-10",
    "claims": [
      {
        "service": "Pharmacy First",
        "provisions": 112,
        "status": "Not submitted",
        "submitted_date": null
      }
    ],
    "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.

## MYS’s own options

The NHSBSA publishes APIs for pharmacy IT system suppliers, not for pharmacies. A supplier's system sends each service provision to the NHSBSA, which uses it to fill in the pharmacy's payment claim in MYS. The pharmacy owner still reviews and submits that claim, the end of month submission and everything else in the portal itself.

| Option | What it covers | What it takes |
| --- | --- | --- |
| MYS APIs for IT suppliers | Service provision data for CPCS, flu and Covid-19 vaccination, smoking cessation, contraception, hypertension case-finding and the New Medicine Service. | An IT system whose supplier has built to the NHSBSA's API specification. Connections come from whitelisted IP addresses. |
| Information reports | Reports that give more visibility of the claims a pharmacy has made. | A request from the pharmacy. |
| MYS by hand | End of month submission, service claims, referred back and disallowed items, Pharmacy Quality Scheme and prescription image requests, one pharmacy at a time. | A personal NHSmail account with access approved for each pharmacy. England only. |

Read on November 12, 2026: [MYS: Pharmacy (NHSBSA)](https://www.nhsbsa.nhs.uk/pharmacies-gp-practices-and-appliance-contractors/dispensing-contractors-information/manage-your-service-mys/mys-pharmacy), [Developer Guide to the NHSBSA API for Community Pharmacy Claims](https://www.nhsbsa.nhs.uk/sites/default/files/2024-02/NHS_BSA_Claim_Interface_Guide_v0_34%20%281%29.pdf), [Manage Your Service Registration and Log-in Guide](https://www.nhsbsa.nhs.uk/sites/default/files/2024-08/Manage%20Your%20Service%20Registration%20and%20Log-in%20Guide%20V1.5.docx).

## Signing in to MYS

MYS signs you in with your personal NHSmail address and its password, after an invitation from Microsoft Invitations on behalf of MYS Registrations. With access to several pharmacies you enter the ODS code of the one you want. With Fous you sign in once through MYS'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

- **Pharmacy First claims are due by the 5th**: Pharmacy First data shows in MYS from the 1st of the following month. The pharmacy owner reviews the claim and submits it by the 5th, or the 6th when a bank holiday falls in the first five days.
- **Your IT system fills the claim, not you**: Your clinical IT system sends service provisions to the NHSBSA by API throughout the month. The pharmacy owner checks that data in MYS and reviews the claim before submitting it.
- **One pharmacy at a time**: A user with several pharmacies enters the ODS code of the one to open after signing in, or a YP code for a group. That is why each method here takes an ODS code as an input.
- **Paper prescriptions still go by post**: The end of month submission is done online in MYS, but the paper prescriptions themselves are still sent to the NHSBSA as before.

## More in Healthcare

- [PECOS](https://fous.com/automate/pecos.md)
- [PCSE Online](https://fous.com/automate/pcse-online.md)
- [CAQH Provider Data Portal](https://fous.com/automate/caqh-provider-data-portal.md)
- [340B ESP](https://fous.com/automate/340b-esp.md)
- [340B OPAIS](https://fous.com/automate/340b-opais.md)
- [Henry Schein online ordering](https://fous.com/automate/henry-schein-online-ordering.md)
- [AAH Hub](https://fous.com/automate/aah-hub.md)
- [ABC Order](https://fous.com/automate/abc-order.md)
- [Alliance Healthcare portal (UK)](https://fous.com/automate/alliance-healthcare-portal-uk.md)
- [Cardinal Health Order Express](https://fous.com/automate/cardinal-health-order-express.md)
- [McKesson Connect](https://fous.com/automate/mckesson-connect.md)
- [PharmaClik](https://fous.com/automate/pharmaclik.md)
- [NHS Supply Chain Online Catalogue](https://fous.com/automate/nhs-supply-chain-online-catalogue.md)
- [McKesson SupplyManager](https://fous.com/automate/mckesson-supplymanager.md)
- [Medline.com](https://fous.com/automate/medline-com.md)

Other industries: [Allianz Maklerportal](/automate/allianz-maklerportal), [Portal Informacyjny Sądów Powszechnych](/automate/portal-informacyjny-sadow-powszechnych), [Extensiv 3PL Warehouse Manager](/automate/extensiv-3pl-warehouse-manager), [LPL ClientWorks](/automate/lpl-clientworks), [myDCLI](/automate/mydcli), [Carrier 360 by J.B. Hunt](/automate/carrier-360-by-j-b-hunt).

## Frequently asked questions

### Does NHSBSA Manage Your Service have an API?

Only for pharmacy IT system suppliers. The NHSBSA's APIs take service provision data from a supplier's system to fill in claims in MYS. There is no published API for a pharmacy to read its own claims, submissions or referred back items, and the claim is still reviewed and submitted in MYS.

### When do I need to submit my Pharmacy First claim in MYS?

By the 5th day of the following month, or the 6th when a bank holiday falls in the first five days. Late claims are accepted until the last day of that month, and claims after that are not paid.

### Can one MYS account see several pharmacies?

Yes. Each ODS code is listed on the access form, and after signing in you enter the ODS code of the pharmacy you want. Pharmacies set up with a YP code can also be opened as a group.

### Who can give a member of staff access to MYS?

The business owner, a director or someone verified through the NHSBSA Information Services Portal approves access. After that, a user with management access can add, change or remove users under Manage Users, for the pharmacies they can see themselves.

### Is Fous affiliated with the NHS Business Services Authority?

No. Fous is an independent product. You use it with your own MYS 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 NHSBSA Manage Your Service (NHS Business Services Authority). 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.
