---
title: "Retrieve a variable recurring payment"
method: GET
path: "/open-banking/vrps/{vrp_id}"
tags: ["Variable Recurring Payments"]
---

# Retrieve a variable recurring payment

`GET /open-banking/vrps/{vrp_id}`

## Request

- Base URL: `https://test-api.acquired.com/v1`
- URL: `https://test-api.acquired.com/v1/open-banking/vrps/{vrp_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/acquired/apis/acquired-api/docs/open-banking/vrps/:vrp_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a variable recurring payment (VRP) using the unique `vrp_id`.

## Path parameters

- `vrp_id` string, required

## Headers

- `Company-Id` string, uuid
- `Mid` string, uuid

## Response `200`

OK

- OpenBankingVrp
  - `vrp_id` string: Unique identifier assigned by Acquired.com for the VRP.
  - `transaction_id` string, uuid: Unique identifier assigned by Acquired.com for the transaction (if applicable).
  - `status` 'awaiting_initiation' | 'pending' | 'received' | 'accepted_customer_profile' | 'accepted_technical_validation' | 'accepted_funds_checked' | 'accepted_settlement_in_process' | 'accepted_with_change' | 'partially_accepted_technical_correct' | 'accepted_without_posting' | 'accepted_settlement_completed_debitor_account' | 'accepted_settlement_completed_creditor_account' | 'insufficient_funds' | 'periodic_limit_reached' | 'rejected' | 'cancelled' | 'blocked' | 'failed' | 'unknown': The machine-readable status of the VRP, at the granularity the bank reports it.
  - `reason` string: A human-readable explanation of the `status`. One of `Insufficient funds`, `Periodic limit reached`, `Amount exceeds maximum per payment limit`, `Mandate cancelled`, `Payment initiation has failed`, `Unexpected status: <status>`, `Payment did not reach a final status within the allowed time`.
  - `end_to_end_identification` string: End-to-end identification for the payment.
  - `links` object[]
    - `rel` string
    - `href` string

## Other responses

- `400`
- `401`
- `403`
- `500`

## Changes

- **2026-11-03** `9c9e8ec96e98`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/acquired/apis/acquired-api/changes/open-banking/vrps/:vrp_id/get.md)

---

[API](https://skmtc.dev/acquired/apis/acquired-api.md) - [All operations](https://skmtc.dev/acquired/apis/acquired-api/llms.txt) - [OpenAPI document](https://skmtc.dev/acquired/apis/acquired-api/revisions/9c9e8ec96e98?raw)