List limit groups

GET
/providers/{providerID}/limit-groups

List your limit groups. Returns an empty list when none exist.

Pagination is cursor-based. Omit cursor to fetch the first page; use nextCursor from each response to fetch the next page.

Auth: API key or bearer token. Scoped to the calling provider.

Request
cURL
curl -X GET https://api.moov.money/providers/{providerID}/limit-groups
Responses
200 400 401 403
The request completed successfully.
{
  "groups": [
    {
      "createdOn": "2026-08-31T12:00:00Z",
      "currency": "USD",
      "dailyAmount": {
        "currency": {
          "code": "USD",
          "decimalPlaces": 2
        },
        "value": "2500.00"
      },
      "dailySendCount": 25,
      "description": "Higher limits for premium customers",
      "groupID": "grp_01HF5J9ZKQT4RXP8M2VYBN3D",
      "monthlyAmount": {
        "currency": {
          "code": "USD",
          "decimalPlaces": 2
        },
        "value": "25000.00"
      },
      "name": "Premium",
      "perTransactionAmount": {
        "currency": {
          "code": "USD",
          "decimalPlaces": 2
        },
        "value": "1000.00"
      },
      "versionID": "ver_01HF5J9ZKQT4RXP8M2VYBN3D",
      "weeklyAmount": {
        "currency": {
          "code": "USD",
          "decimalPlaces": 2
        },
        "value": "5000.00"
      }
    }
  ]
}
Malformed request: the body or headers failed validation.
Authentication missing, invalid, or insufficient.
Authentication present but the action is forbidden for this principal/claim.

Headers

X-Moov-Version

string
Set this header to the API version being targeted (e.g. v2026.07.00). When omitted, the server applies its default version.

Path parameters

providerID

string required
Your provider account ID.

Query parameters

cursor

string
Opaque pagination cursor from a previous response’s nextCursor. Omit to fetch the first page.

limit

integer <int32>
Maximum number of groups to return. Defaults to 25; values outside 1-100 return 400.

Response

Response envelope for list limit groups.

nextCursor

string
Opaque cursor for the next page; absent on the last page.

hasMore

boolean required
Whether another page of results follows this one.

groups

array<object> required
The page of limit groups.
Show child attributes

groups[]

createdOn

string<date-time>
When this version was created.

currency

string
Three-letter ISO 4217 currency the group is denominated in (v1 USD-only).

dailyAmount

object
Trailing 24h amount ceiling.
Show child attributes

groups[].dailyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

groups[].dailyAmount.currency

decimalPlaces

integer<uint8> required
Number of minor-unit decimal places for code. Required.

numericCode

string
ISO 4217 numeric currency code, if known. Informational only.

name

string
Human-readable currency name, if known. Informational only.

code

string required
Uppercase 3-letter ISO 4217 currency code.

value

string required
Decimal amount as a string.

dailySendCount

integer<int64>
Trailing 24h send-count ceiling.

description

string
Optional description.

disabledOn

string<date-time>
When the group was disabled. Set on the version that removes the group.

groupID

string
System-assigned group identifier.

monthlyAmount

object
Trailing 30d amount ceiling.
Show child attributes

groups[].monthlyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

groups[].monthlyAmount.currency

decimalPlaces

integer<uint8> required
Number of minor-unit decimal places for code. Required.

numericCode

string
ISO 4217 numeric currency code, if known. Informational only.

name

string
Human-readable currency name, if known. Informational only.

code

string required
Uppercase 3-letter ISO 4217 currency code.

value

string required
Decimal amount as a string.

name

string
Display name.

perTransactionAmount

object
Per-send amount ceiling.
Show child attributes

groups[].perTransactionAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

groups[].perTransactionAmount.currency

decimalPlaces

integer<uint8> required
Number of minor-unit decimal places for code. Required.

numericCode

string
ISO 4217 numeric currency code, if known. Informational only.

name

string
Human-readable currency name, if known. Informational only.

code

string required
Uppercase 3-letter ISO 4217 currency code.

value

string required
Decimal amount as a string.

versionID

string
Latest version ID; send this back as expectedVersionID on your next mutation.

weeklyAmount

object
Trailing 7d amount ceiling.
Show child attributes

groups[].weeklyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

groups[].weeklyAmount.currency

decimalPlaces

integer<uint8> required
Number of minor-unit decimal places for code. Required.

numericCode

string
ISO 4217 numeric currency code, if known. Informational only.

name

string
Human-readable currency name, if known. Informational only.

code

string required
Uppercase 3-letter ISO 4217 currency code.

value

string required
Decimal amount as a string.