---
api: 'Open Banking API'
---

# Retrieve all account's standing orders

Get a list of all the standing orders for a specific user account.

:::note
In compliance with PSD2 SCA regulations, access to this endpoint is only allowed within the first 5 minutes after the Revolut user has authorised the consent.
After those 5 minutes, access to this endpoint is denied, and an HTTP `403` error is returned.
:::

See also [Tutorials: Get account and transaction information](/docs/guides/build-banking-apps/tutorials/get-account-and-transaction-information).

## Endpoint

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

## Parameters

### header parameters

- `x-fapi-financial-id` (string, required)
  The unique ID of the [ASPSP](/docs/guides/build-banking-apps/glossary) that the request is issued to.
  The ID of Revolut is `001580000103UAvAAM`.

- `x-fapi-customer-last-logged-time` (string, optional)
  The date and time when the [PSU](/docs/guides/build-banking-apps/glossary) last logged in with the [TPP](/docs/guides/build-banking-apps/glossary).
  
  All dates in the HTTP headers are represented as [RFC 7231](https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.1.1) Full Dates.
  For example: <nobr>`Sun, 10 Sep 2017 19:43:31 UTC`</nobr>.

- `x-fapi-customer-ip-address` (string, optional)
  The IP address of the [PSU](/docs/guides/build-banking-apps/glossary) if the PSU is logged in with the [TPP](/docs/guides/build-banking-apps/glossary).

- `x-fapi-interaction-id` (string, optional)
  An [RFC4122](https://datatracker.ietf.org/doc/html/rfc4122) UUID used as a correlation ID.

- `Authorization` (string, required)
  The access token that you've generated.
  For more information, see [Generate an access token](/docs/guides/build-banking-apps/get-started/get-access-token).

- `x-customer-user-agent` (string, optional)
  The user agent that the [PSU](/docs/guides/build-banking-apps/glossary) is using.

### path parameters

- `AccountId` (string, required)
  The ID of the account.

## Returns

### 200

Standing Orders Read

#### Response attributes

- `Data` (object)
  - `Data.StandingOrder` (array of object, optional)
    - `Data.StandingOrder[].AccountId` (string)
        The unique and immutable ID to identify the account resource.
        This ID has no meaning to the account owner.
    - `Data.StandingOrder[].StandingOrderId` (string, optional)
        The unique and immutable ID to identify the standing order resource.
        This ID has no meaning to the account owner.
    - `Data.StandingOrder[].Frequency` (string)
        The frequency of the standing order:
        - `EvryDay`: Every day
        - `IntrvlWkDay`: Only one week interval is supported (01) and any day within the week (01 to 07)
        - `IntrvlMnthDay`: Only one month interval is supported (01) and any day within the month (1 to 31)
        
        Example values:
        - `EvryDay`
        - `IntrvlWkDay:01:0[1-7]`
        - `IntrvlMnthDay:01:(0[1-9]|[12][0-9]|3[01])`
    - `Data.StandingOrder[].Reference` (string, optional)
        The unique reference that the creditor assigns to refer to the payment transaction.
        
        If available, the initiating party should provide this reference in the structured remittance information to enable reconciliation by the creditor upon receipt of the amount of money.
        
        If the business context requires the use of a creditor reference or a payment remit identification, and only one identifier can be passed through the end-to-end chain, the creditor's reference or payment remittance identification should be quoted in the end-to-end transaction identification.
    - `Data.StandingOrder[].FirstPaymentAmount` (object, optional)
        The amount of the first standing order payment.
      - `Data.StandingOrder[].FirstPaymentAmount.Amount` (string)
          The amount of money where the unit of currency is explicit and compliant with [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
      - `Data.StandingOrder[].FirstPaymentAmount.Currency` (string)
          [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.
    - `Data.StandingOrder[].FirstPaymentDateTime` (string, optional)
        The date the first payment for a standing order schedule is made.
        
        All dates in the JSON payloads are represented in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time format.
        All date-time fields in responses must include the timezone.
        
        For example: `2017-04-05T10:43:07+00:00`.
    - `Data.StandingOrder[].NextPaymentAmount` (object, optional)
        The amount of the next standing order payment.
      - `Data.StandingOrder[].NextPaymentAmount.Amount` (string)
          The amount of money where the unit of currency is explicit and compliant with [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
      - `Data.StandingOrder[].NextPaymentAmount.Currency` (string)
          [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.
    - `Data.StandingOrder[].StandingOrderStatusCode` (enum, optional)
        The status of the standing order.
        Possible enum values:

        - `Active`
        - `Inactive`
    - `Data.StandingOrder[].CreditorAccount` (object, optional)
        The details to identify the account.
      - `Data.StandingOrder[].CreditorAccount.SchemeName` (enum)
          The name of the identification scheme.
          
          Note the scheme `UK.Revolut.InternalAccountId` is an internal account identifier for those accounts which don't have externally available identifiers.
          It cannot be used to send or receive funds.
          Possible enum values:

          - `UK.OBIE.IBAN`
          - `UK.OBIE.SortCodeAccountNumber`
          - `US.RoutingNumberAccountNumber`
          - `US.BranchCodeAccountNumber`
          - `UK.Revolut.InternalAccountId`
      - `Data.StandingOrder[].CreditorAccount.Identification` (string)
          The identification of the account.
          
          :::warning[Unique account identifier]
          This field will typically contain an account number or an IBAN which must not be considered as a unique identifier for the account. Several currency subacounts can share this same identifier.
          
          If you need a unique identifier for each account, ensure you use the `Data.Account.AccountId` instead.
          :::
      - `Data.StandingOrder[].CreditorAccount.Name` (string, optional)
          The account name that the account servicing institution assigns.
          
          The account name is the name or names of the account owner(s) represented at an account level.
          
          The account name is not the product name or the nickname of the account.
      - `Data.StandingOrder[].CreditorAccount.SecondaryIdentification` (string, optional)
          The secondary account ID that the account servicing institution assigns.
          
          Building societies can use this ID to identify accounts with a roll number in addition to a sort code and account number combination.
- `Links` (object)
    Links relevant to the payload.
  - `Links.Self` (string)
      The absolute URI to the resource.
  - `Links.Next` (string, optional)
      The absolute URI to the next pagination resource.
  - `Links.Prev` (string, optional)
      The absolute URI to the previous pagination resource.
- `Meta` (object)
    Meta data relevant to the payload.
  - `Meta.TotalPages` (integer, optional)
      Used for pagination. Indicates how many pages of results are available.

## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad request |
| 401 | Unauthorized  Returned, for instance, when the access token has expired or is invalid, for example, when the consent has been revoked, or when the consent lacks necessary permissions. |
| 403 | Forbidden  Returned, for example, when the 5-minute [SCA](https://www.openbanking.org.uk/glossary/strong-customer-authentication/) session has expired. |
| 405 | Method Not Allowed |
| 406 | Not Acceptable |
| 429 | Too Many Requests |
| 500 | Internal Server Error |