List blocked IP addresses
Retrieves a paginated list of IP addresses currently blocked for the specified user. Optional query parameters allow searching, filtering, and sorting the results.
API-KeyX-API-KEY<token>MonoCloud APIs require authentication with an API key. Retrieve your key from the Tenant Settings section of the MonoCloud dashboard and include it in the request header as: X-API-Key: <your_api_key>
The unique identifier of the user.
The page number to retrieve.
int321 <= value1The number of blocked IPs to return per page.
int321 <= value <= 5010Optional Lucene-style filter expression used to search by attributes.
Sort expression in the format field:direction, where direction is 1 for ascending or -1 for descending.
Supported fields include - block_until, last_sign_in_attempt, last_sign_in_success.
Response Headers
200
Returns the x-Pagination header
Number of items returned per page.
int32The current page number.
int32Total number of items available.
int32Indicates whether a previous page exists.
Indicates whether a next page exists.
Response Body
application/json
The user’s blocked IP addresses were retrieved successfully
TypeScript Definitions
Use the response body type in TypeScript.
Returns an array. Each item has the fields below.
User IP Access Details: Returns sign-in activity for a specific IP address.
Errors
curl -X GET "https://your-domain.us.monocloud.com/api/users/WUgDGqaqzqkRmsgd3PFAT/blocked_ips?page=1&size=10&filter=%28failure_count%3A%5B3+TO+*%5D+AND+blocked_until%3A%5B1704067200+TO+*%5D%29&sort=block_until%3A1" \ -H "X-API-KEY: <token>"[ { "failure_count": 0, "block_until": null, "sign_in_attempts_count": 0, "ip": "string", "last_sign_in_attempt": 0 }]Update user public data PATCH
Applies a partial update to the public data associated with the specified user. Only fields included in the request are updated. Public data fields can be removed by sending a null value for the corresponding key.
Reset IP lockout POST
Removes the lockout applied to the specified IP due to excessive failed authentication attempts, allowing sign-in attempts from that IP again. Providing the value all resets lockouts for every IP associated with the user.