Get provider limit policy

GET
/providers/{providerID}/limits

Read your provider’s default limit policy: the ceilings applied to participants with no limit group and no override.

Limits resolve from the most specific layer down: a participant override beats the participant’s limit groups, a limit group beats your provider default, and your provider default applies when there is neither. The platform maximum clamps every ceiling.

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

Request
cURL
curl -X GET https://api.moov.money/providers/{providerID}/limits
Responses
200 401 403 404
The request completed successfully.
{
  "policy": {
    "createdOn": "2026-08-31T12:00:00Z",
    "currency": "USD",
    "dailyAmount": {
      "currency": {
        "code": "USD",
        "decimalPlaces": 2
      },
      "value": "1000.00"
    },
    "dailySendCount": 10,
    "monthlyAmount": {
      "currency": {
        "code": "USD",
        "decimalPlaces": 2
      },
      "value": "10000.00"
    },
    "perTransactionAmount": {
      "currency": {
        "code": "USD",
        "decimalPlaces": 2
      },
      "value": "500.00"
    },
    "versionID": "ver_01HF5J9ZKQT4RXP8M2VYBN3D",
    "weeklyAmount": {
      "currency": {
        "code": "USD",
        "decimalPlaces": 2
      },
      "value": "2500.00"
    }
  }
}
Authentication missing, invalid, or insufficient.
Authentication present but the action is forbidden for this principal/claim.
The requested resource was not found.

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.

Response

Response envelope for the provider limit policy; the policy is nested under policy.

policy

object required
The provider default limit policy.
Show child attributes

policy

perTransactionAmount

object
Per-send amount ceiling.
Show child attributes

policy.perTransactionAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

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

policy.dailyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

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

policy.weeklyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

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

policy.monthlyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

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

currency

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