Get a remitter's limits
Returns the same view for a remitter: the sender you name in additional_information.remitter_verification on a transfer. Usage counts only transfers that carry it, on a policy with attested tiers. An unknown remitter gets the policy's default tier.
Path Parameters
Your ID for the sender, 1 to 255 characters. It is case-sensitive.
Responses
| Status | Description |
|---|---|
200 |
The remitter's limits |
400 |
The ID is missing or invalid |
404 |
The subject is not yours, or you have no limits policy. Having no policy does not mean that no limits apply. |
503 |
Gravv cannot read limits right now. Retry. |
200 response
Possible values: customer, remitter
The tier, such as basic. Empty when there is none.
How the tier was chosen
Possible values: operator, kyc, attested, default, per_transfer_attestation
tier when the caps are the subject's own, floor when they are the lowest tier's (the tier is set on each transfer), and none when they are not known
Possible values: tier, floor, none
enforce pauses transfers over a cap. shadow only records them. off checks nothing.
Possible values: off, shadow, enforce
True when the sender may not send transfers
False when usage could not be read. used_usd is then null.
Daily, weekly and monthly windows follow the UTC calendar. The annual window is the last 12 months.
Amounts in USD with 2 decimal places. A null cap_usd means no cap when caps_basis is tier.
Null for the per_transfer window, and when usage could not be read
The amount left to send in the window. 0.00 for a blocked sender.
Amounts in USD with 2 decimal places. A null cap_usd means no cap when caps_basis is tier.
Null for the per_transfer window, and when usage could not be read
The amount left to send in the window. 0.00 for a blocked sender.
Amounts in USD with 2 decimal places. A null cap_usd means no cap when caps_basis is tier.
Null for the per_transfer window, and when usage could not be read
The amount left to send in the window. 0.00 for a blocked sender.
Amounts in USD with 2 decimal places. A null cap_usd means no cap when caps_basis is tier.
Null for the per_transfer window, and when usage could not be read
The amount left to send in the window. 0.00 for a blocked sender.
Amounts in USD with 2 decimal places. A null cap_usd means no cap when caps_basis is tier.
True when transfers over the annual cap need Gravv's approval
The next tier up and its caps
Caps in USD. Null means no cap.
What the subject needs for that tier
Tiers a transfer can reach, when the tier is set on each transfer
{
"data": {
"subject_type": "remitter",
"subject_id": "rem_8842",
"tier_code": "",
"tier_assignment": "per_transfer_attestation",
"caps_basis": "floor",
"mode": "enforce",
"blocked": false,
"usage_available": true,
"as_of": "2026-10-13T09:15:22Z",
"windows": {
"per_transfer": {
"cap_usd": "1000.00",
"used_usd": null,
"remaining_usd": null
},
"daily": {
"cap_usd": "3000.00",
"used_usd": "0.00",
"remaining_usd": "3000.00"
},
"weekly": {
"cap_usd": null,
"used_usd": "0.00",
"remaining_usd": null
},
"monthly": {
"cap_usd": "10000.00",
"used_usd": "0.00",
"remaining_usd": "10000.00"
},
"annual": {
"cap_usd": "0.00",
"used_usd": "0.00",
"remaining_usd": "0.00",
"requires_approval": true
}
},
"next_tier": null,
"candidate_tiers": [
{
"tier_code": "T1",
"rank": 1,
"tier_caps": {
"per_transfer": "1000",
"daily": "3000",
"weekly": null,
"monthly": "10000",
"annual": null,
"annual_requires_approval": true
},
"caps": {
"per_transfer": "1000",
"daily": "3000",
"weekly": null,
"monthly": "10000",
"annual": null,
"annual_requires_approval": true
}
}
]
},
"error": null
}
400 response
404 response
{
"data": null,
"error": "not found: no limits policy applies"
}
503 response
{
"data": null,
"error": "limits are temporarily unavailable, please retry",
"code": "ERROR_CODE_LIMITS_UNAVAILABLE"
}
Authorization
- ApiKeyAuth