Create limit group

POST
/providers/{providerID}/limit-groups

Create a limit group: a named set of ceilings that applies to its member participants, between your provider default and a participant override.

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

Request
cURL
curl -X POST https://api.moov.money/providers/{providerID}/limit-groups \
  -H "Content-Type: application/json" \
  -d '{
  "dailyAmount": {
    "currency": {
      "code": "USD",
      "decimalPlaces": 2
    },
    "value": "1000.00"
  },
  "dailySendCount": 10,
  "description": "Higher limits for premium customers",
  "monthlyAmount": {
    "currency": {
      "code": "USD",
      "decimalPlaces": 2
    },
    "value": "10000.00"
  },
  "name": "Premium",
  "perTransactionAmount": {
    "currency": {
      "code": "USD",
      "decimalPlaces": 2
    },
    "value": "500.00"
  },
  "weeklyAmount": {
    "currency": {
      "code": "USD",
      "decimalPlaces": 2
    },
    "value": "2500.00"
  }
}'
Responses
201 400 401 403 422
The resource was successfully created.
{
  "group": {
    "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.
The request was well-formed but couldn’t be processed (e.g. card declined).

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.

Request

application/json
A limit group to create.

description

string
Optional description.

perTransactionAmount

object
Per-send amount ceiling.
Show child attributes

perTransactionAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

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.

dailyAmount

object
Trailing 24h amount ceiling.
Show child attributes

dailyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

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.

weeklyAmount

object
Trailing 7d amount ceiling.
Show child attributes

weeklyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

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.

monthlyAmount

object
Trailing 30d amount ceiling.
Show child attributes

monthlyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

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.

dailySendCount

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

name

string required
Display name.

Response

Response envelope for a single limit group; the group is nested under group.

group

object required
The limit group.
Show child attributes

group

name

string required
Display name.

description

string
Optional description.

currency

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

perTransactionAmount

object
Per-send amount ceiling.
Show child attributes

group.perTransactionAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

group.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.

dailyAmount

object
Trailing 24h amount ceiling.
Show child attributes

group.dailyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

group.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.

weeklyAmount

object
Trailing 7d amount ceiling.
Show child attributes

group.weeklyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

group.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.

monthlyAmount

object
Trailing 30d amount ceiling.
Show child attributes

group.monthlyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

group.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.

dailySendCount

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

versionID

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

createdOn

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

disabledOn

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

groupID

string required
System-assigned group identifier.