Retrieve Customer Velocity Limit Configuration

---

Overview

You can retrieve Customer Velocity Limit Configuration using the GET method, as described below. Velocity limits define the maximum number and cumulative amount of transactions a customer can perform. They can be configured separately for credit and debit transactions, enabling precise risk management and transaction control.

---

Resource Access

Production (api.ahrvo.network)

GET https://api.ahrvo.network/banking/us2/v1/customer/id/{id}/configuration/velocityControl

Staging (gateway.ahrvo.network)

GET https://gateway.ahrvo.network/banking/us2/v1/customer/id/{id}/configuration/velocityControl

---

Authentication

Header	Description
Authorization	Bearer {JWT token}
x-api-key	Your API key
Content-Type	application/json

---

Path Parameters

Parameter	Type	Description
id	integer	Internal customer ID

---

Response Fields

Transaction Limit — Credit

Field	Type	Description
transactionLimit.credit.totalCount	string	Maximum number of credit transactions allowed
transactionLimit.credit.totalAmount	string	Maximum cumulative credit transaction amount
transactionLimit.credit.methodControl.ach.totalCount	string	Maximum ACH credit transactions
transactionLimit.credit.methodControl.ach.totalAmount	string	Maximum cumulative ACH credit amount
transactionLimit.credit.methodControl.card.totalCount	string	Maximum card credit transactions
transactionLimit.credit.methodControl.card.totalAmount	string	Maximum cumulative card credit amount
transactionLimit.credit.methodControl.check.totalCount	string	Maximum check credit transactions
transactionLimit.credit.methodControl.check.totalAmount	string	Maximum cumulative check credit amount
transactionLimit.credit.lastUpdatedOn	string	Timestamp of last update

Transaction Limit — Debit

Field	Type	Description
transactionLimit.debit.totalCount	string	Maximum number of debit transactions allowed
transactionLimit.debit.totalAmount	string	Maximum cumulative debit transaction amount
transactionLimit.debit.methodControl.ach.totalCount	string	Maximum ACH debit transactions
transactionLimit.debit.methodControl.ach.totalAmount	string	Maximum cumulative ACH debit amount
transactionLimit.debit.methodControl.card.totalCount	string	Maximum card debit transactions
transactionLimit.debit.methodControl.card.totalAmount	string	Maximum cumulative card debit amount
transactionLimit.debit.methodControl.check.totalCount	string	Maximum check debit transactions
transactionLimit.debit.methodControl.check.totalAmount	string	Maximum cumulative check debit amount
transactionLimit.debit.methodControl.wire.totalCount	string	Maximum wire debit transactions
transactionLimit.debit.methodControl.wire.totalAmount	string	Maximum cumulative wire debit amount
transactionLimit.debit.methodControl.internationalWire.totalCount	string	Maximum international wire debit transactions
transactionLimit.debit.methodControl.internationalWire.totalAmount	string	Maximum cumulative international wire debit amount
transactionLimit.debit.methodControl.virtualCard.totalCount	string	Maximum virtual card debit transactions
transactionLimit.debit.methodControl.virtualCard.totalAmount	string	Maximum cumulative virtual card debit amount
transactionLimit.debit.lastUpdatedOn	string	Timestamp of last update

---

Example Request

GET /banking/us2/v1/customer/id/4260651/configuration/velocityControl HTTP/1.1
Host: api.ahrvo.network
Authorization: Bearer {placeholder("JWT token")}
x-api-key: {placeholder("your-api-key")}
Content-Type: application/json

---

Example Response

{
    "transactionLimit": {
        "credit": {
            "totalCount": "99999999",
            "totalAmount": "9999999.00",
            "methodControl": {
                "ach": {
                    "totalCount": "999",
                    "totalAmount": "999.00"
                },
                "card": {
                    "totalCount": "99999999",
                    "totalAmount": "9999999.00"
                },
                "check": {
                    "totalCount": "99999999",
                    "totalAmount": "9999999.00"
                }
            },
            "lastUpdatedOn": "08/29/2025 07:44:06"
        },
        "debit": {
            "totalCount": "9999999",
            "totalAmount": "9999999.00",
            "methodControl": {
                "ach": {
                    "totalCount": "99999",
                    "totalAmount": "9999999.00"
                },
                "card": {
                    "totalCount": "99999",
                    "totalAmount": "9999999.00"
                },
                "check": {
                    "totalCount": "99999",
                    "totalAmount": "9999999.00"
                },
                "wire": {
                    "totalCount": "99999",
                    "totalAmount": "9999999.00"
                },
                "internationalWire": {
                    "totalCount": "99999",
                    "totalAmount": "9999999.00"
                },
                "virtualCard": {
                    "totalCount": "99999",
                    "totalAmount": "9999999.00"
                }
            },
            "lastUpdatedOn": "08/29/2025 07:44:06"
        }
    }
}

Response Status

HTTP Status: 200 OK

---

Supported Methods by Transaction Type

Method	Credit	Debit
ACH	✅	✅
Card	✅	✅
Check	✅	✅
Wire	❌	✅
International Wire	❌	✅
Virtual Card	❌	✅

---

Important Notes

Velocity Limits

Velocity limits are customer-level controls that restrict the total number and cumulative dollar amount of transactions. They help prevent fraud and enforce compliance requirements.

Related Endpoints

Use the Update Customer Velocity Limit Configuration endpoint to modify these limits.

---

Interactive API Explorer