UK Open Banking · Example Payload

Vrp Examples

Illustrative request and response examples for the UK Open Banking Variable Recurring Payments (VRP) API v4.0.1

Open BankingFinancial-ServicesPaymentsAccount InformationPSD2UKBankingFintechRegulated

Vrp Examples is an example object payload from UK Open Banking, with 5 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

titleversionsourcedescriptionexamples

Example Payload

{
  "title": "OBL VRP Profile",
  "version": "4.0.1",
  "source": "https://raw.githubusercontent.com/OpenBankingUK/read-write-api-specs/master/dist/openapi/vrp-openapi.yaml",
  "description": "Illustrative request and response examples for the UK Open Banking Variable Recurring Payments (VRP) API v4.0.1",
  "examples": [
    {
      "operationId": "CreateDomesticVRPConsents",
      "path": "/domestic-vrp-consents",
      "method": "POST",
      "type": "request",
      "mediaType": "application/json",
      "description": "Create a Variable Recurring Payment consent with spending controls",
      "example": {
        "Data": {
          "ControlParameters": {
            "PSUAuthenticationMethods": ["UK.OBIE.SCA"],
            "ValidFromDateTime": "2026-06-13T00:00:00+00:00",
            "ValidToDateTime": "2027-06-13T00:00:00+00:00",
            "MaximumIndividualAmount": {
              "Amount": "100.00",
              "Currency": "GBP"
            },
            "PeriodicLimits": [
              {
                "Amount": "1000.00",
                "Currency": "GBP",
                "PeriodAlignment": "Calendar",
                "PeriodType": "Month"
              }
            ]
          },
          "Initiation": {
            "CreditorAccount": {
              "SchemeName": "UK.OBIE.SortCodeAccountNumber",
              "Identification": "70000170000001",
              "Name": "Amy Knight"
            }
          }
        },
        "Risk": {
          "PaymentContextCode": "PartyToParty"
        }
      }
    },
    {
      "operationId": "CreateDomesticVRPConsents",
      "path": "/domestic-vrp-consents",
      "method": "POST",
      "statusCode": "201",
      "type": "response",
      "mediaType": "application/json",
      "description": "Successful VRP consent creation",
      "example": {
        "Data": {
          "ConsentId": "vrp-con-001",
          "CreationDateTime": "2026-06-13T10:00:00+00:00",
          "Status": "AwaitingAuthorisation",
          "StatusUpdateDateTime": "2026-06-13T10:00:00+00:00",
          "ControlParameters": {
            "PSUAuthenticationMethods": ["UK.OBIE.SCA"],
            "ValidFromDateTime": "2026-06-13T00:00:00+00:00",
            "ValidToDateTime": "2027-06-13T00:00:00+00:00",
            "MaximumIndividualAmount": {
              "Amount": "100.00",
              "Currency": "GBP"
            },
            "PeriodicLimits": [
              {
                "Amount": "1000.00",
                "Currency": "GBP",
                "PeriodAlignment": "Calendar",
                "PeriodType": "Month"
              }
            ]
          },
          "Initiation": {
            "CreditorAccount": {
              "SchemeName": "UK.OBIE.SortCodeAccountNumber",
              "Identification": "70000170000001",
              "Name": "Amy Knight"
            }
          }
        },
        "Risk": {
          "PaymentContextCode": "PartyToParty"
        },
        "Links": {
          "Self": "https://api.alphabank.com/open-banking/v4.0/pisp/domestic-vrp-consents/vrp-con-001"
        },
        "Meta": {
          "TotalPages": 1
        }
      }
    },
    {
      "operationId": "CreateDomesticVrps",
      "path": "/domestic-vrps",
      "method": "POST",
      "type": "request",
      "mediaType": "application/json",
      "description": "Initiate a single VRP payment under an authorised consent",
      "example": {
        "Data": {
          "ConsentId": "vrp-con-001",
          "PSUAuthenticationMethod": "UK.OBIE.SCA",
          "VRPType": "UK.OBIE.VRPType.Sweeping",
          "Initiation": {
            "CreditorAccount": {
              "SchemeName": "UK.OBIE.SortCodeAccountNumber",
              "Identification": "70000170000001",
              "Name": "Amy Knight"
            }
          },
          "Instruction": {
            "InstructionIdentification": "VRP-20260613-001",
            "EndToEndIdentification": "e2e-vrp-001",
            "InstructedAmount": {
              "Amount": "55.00",
              "Currency": "GBP"
            },
            "CreditorAccount": {
              "SchemeName": "UK.OBIE.SortCodeAccountNumber",
              "Identification": "70000170000001",
              "Name": "Amy Knight"
            }
          }
        },
        "Risk": {
          "PaymentContextCode": "PartyToParty"
        }
      }
    }
  ]
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/vrp-examples"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.