---
title: "Retrieve the standing orders for an account"
method: GET
path: "/accounts/{accountId}/standing-orders"
tags: ["standing orders"]
---

# Retrieve the standing orders for an account

`GET /accounts/{accountId}/standing-orders`

## Request

- Base URL: `https://api.moneyhub.co.uk/v3`
- URL: `https://api.moneyhub.co.uk/v3/accounts/{accountId}/standing-orders`
- Auth: API key in header `Authorization`

Requires **accounts:read** and either of **standing_orders:read** or **standing_orders_detail:read** scopes.

## Path parameters

- `accountId` string, uuid, required

## Response `200`

Successful Standing Orders Response

- object
  - `data` StandingOrder[]
    - `id` string, required: The unique identity of the standing order
    - `status` 'Active' | 'Inactive'
    - `reference` string: The name or description given to the standing order
    - `frequency` object, required
      - `repeat` 'Daily' | 'Weekly' | 'Monthly' | 'Quarterly' | 'Yearly', required
      - `day` number: The number of the day on which to repeat the payment
      - `week` number: The number of the week on which to repeat the payment
      - `month` number: The number of the month on which to repeat the payment
      - `onlyWorkDays` boolean: Specifies whether the payment should only be made on working days
      - `region` 'ENGLISH' | 'SCOTTISH' | 'RECEIVED': The region for dates of quarterly payments
    - `numberOfPayments` number: The number of recurring payments to complete the standing order
    - `firstPaymentDate` string, date-time
    - `nextPaymentDate` string, date-time
    - `finalPaymentDate` string, date-time
    - `firstPaymentAmount` object: The value of the first payment in minor units of the currency, eg. pennies for GBP.
      - `value` integer: The amount of the transaction in minor units of the currency, eg. pennies for GBP, negative means money going out of an account, positive means money coming into an account.
      - `majorUnits` integer: The major units of the value, based on the values currency, eg. pounds for GBP.
      - `minorUnits` integer: The minor units of the value, based on the values currency, eg. pennies for GBP.
      - `currency` string: The currency of the amount
    - `nextPaymentAmount` object: The value of the next payment in minor units of the currency, eg. pennies for GBP.
      - `value` integer: The amount of the transaction in minor units of the currency, eg. pennies for GBP, negative means money going out of an account, positive means money coming into an account.
      - `majorUnits` integer: The major units of the value, based on the values currency, eg. pounds for GBP.
      - `minorUnits` integer: The minor units of the value, based on the values currency, eg. pennies for GBP.
      - `currency` string: The currency of the amount
    - `finalPaymentAmount` object: The value of the final payment in minor units of the currency, eg. pennies for GBP.
      - `value` integer: The amount of the transaction in minor units of the currency, eg. pennies for GBP, negative means money going out of an account, positive means money coming into an account.
      - `majorUnits` integer: The major units of the value, based on the values currency, eg. pounds for GBP.
      - `minorUnits` integer: The minor units of the value, based on the values currency, eg. pennies for GBP.
      - `currency` string: The currency of the amount
    - `currency` string: The currency of the standing order
    - `payee` object: The details to identify the beneficiary account. It requires the **standing_orders_detail:read** scope.
      - `name` string: The name or names of the account owner(s)
      - `sortCodeAccountNumber` string: For cash accounts. Populated with the 6 digit Sort Code and 8 digit Account Number.
      - `iban` string: For cash accounts. Populated with the full IBAN number.
      - `pan` string: For card accounts. Populated with the Primary Account Number.
  - `links` Links
    - `next` string, uri: The url to retrieve the next page of results from
    - `prev` string, uri: The url to retrieve the previous page of results from
    - `self` string, uri, required: The url of the current resource(s)
  - `meta` object

## Other responses

- `401`: Unsuccessful Response - Not authorised - Missing authorization header - Invalid access Token
- `403`: Unsuccessful Response - Forbidden - Invalid scopes
- `404`: Unsuccessful Response - Resource Not found

---

[API](https://skmtc.dev/moneyhubenterprise/apis/moneyhub-data-api-v3.md) - [All operations](https://skmtc.dev/moneyhubenterprise/apis/moneyhub-data-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/moneyhubenterprise/apis/moneyhub-data-api-v3/revisions/2e08b5dbee56?raw)