Common
Get metered-dimension limits
Returns the caller's metered-dimension limit configuration (subscription- and user-level, monthly and yearly).
AuthorizationBearer <token>
JWT token to authenticate the request.
In: header
X-Api-Key<token>
API key, sent as a request header.
In: header
Query Parameters
scope?string
Case-insensitive match against the allowed values below. An unrecognized value returns INVALID_SCOPE_VALUE (400).
Value in
- "Global"
- "User"
- "Subscription"
- "Account"
application?string
Case-insensitive match against the allowed values below. An unrecognized value returns INVALID_APPLICATION_VALUE (400).
Value in
- "MDS"
- "MD"
- "MCLM"
- "MHCW"
- "MH"
subscriptionId?string
If present, must be a GUID belonging to the caller; substitutes that subscription's context for the caller's own subscription. Otherwise the caller's own subscription context is used.
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/common/limits/get"{ "result": { "data": { "settings": [ { "name": "ENVELOPES", "allocatedResources": "1000 per month", "displayName": "Envelopes Sent", "groups": "Signature,Core", "pricePerUnit": 0.05, "subscriptionLimits": { "monthly": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "ENVELOPES_LIMIT_SUBSCRIPTION_MONTH", "value": "1000", "defaultValue": "500", "meta": { "application": "MH", "scope": { "name": "Subscription" }, "category": { "name": "Limits" }, "subCategory": { "name": "Envelopes" }, "group": { "key": "limits", "name": "Limits" } } } ], "yearly": [] }, "userLimits": { "monthly": [], "yearly": [] } } ] }, "statusCode": 200, "message": "OK" }, "origin": "string", "dateTime": "string", "operationId": "string"}{ "error": { "innerErrors": [ { "code": "INVALID_SCOPE_VALUE", "message": "The provided scope value is not recognized.", "userMessage": "Invalid scope value provided." } ], "message": "The provided scope value is not recognized.", "statusCode": 400 }, "dateTime": "2026-01-01T12:00:00.0000000+00:00", "operationId": "common-limits-get", "origin": ""}{ "error": { "innerErrors": [ { "code": "VALIDATION_ERROR", "message": "Name is required.", "userMessage": "Name is required." } ], "message": "One or more validation errors occurred.", "statusCode": 400 }, "dateTime": "2026-01-01T12:00:00.0000000+00:00", "operationId": "00-abc123-00", "origin": "self-service-portal"}{ "error": { "innerErrors": [ { "code": "VALIDATION_ERROR", "message": "Name is required.", "userMessage": "Name is required." } ], "message": "One or more validation errors occurred.", "statusCode": 400 }, "dateTime": "2026-01-01T12:00:00.0000000+00:00", "operationId": "00-abc123-00", "origin": "self-service-portal"}{ "error": { "innerErrors": [ { "code": "FUNCTION_EXECUTION_ERROR", "message": "An unexpected error occurred while processing the request.", "userMessage": "Something went wrong. Please contact support." } ], "message": "An unexpected error occurred while processing the request.", "statusCode": 500 }, "dateTime": "2026-01-01T12:00:00.0000000+00:00", "operationId": "common-limits-get", "origin": ""}