Greip Dashboard – Managing Custom Rules
Adding custom rules
To add a custom rule, follow these steps:1
First Step
Go to the Custom Rules page from
the account dashboard.
2
Second Step
Click on the ‘Add Rule’ button from the top right corner of the page to
create a new custom rule.
3
Third Step
Give it a title that describes the rule. This will help you identify the
rule later, and when the custom rule is applied to an API request, it will
be returned in the API response along with the rule ID.
4
Fourth Step
Choose the endpoint then define the conditions and action for the custom
rule.

Defining conditions and action
5
Fifth Step
Click the “Add rule” button to save the custom rule.
Sample response with custom rule
When a custom rule is applied to an API request, the custom rule ID will be returned in the API response. Here is an example of a response with a custom rule:Definitions of custom rule actions
Custom rules can be defined with the following actions:IP geolocation
IP geolocation
This includes both the
IP geolocation
and IP lookup
endpoints.- Add to blacklist: Marks the IP address as blacklisted. It adds a
blacklisted
property with the value oftrue
under thesecurity
object in the API response. - Add to whitelist: Marks the IP address as whitelisted. It adds a
blacklisted
property with the value offalse
under thesecurity
object in the API response.
IP reputation
IP reputation
- Add to blacklist: Marks the IP address as blacklisted. It adds a
blacklisted
property with the value oftrue
under thethreats
object in the API response. - Add to whitelist: Marks the IP address as whitelisted. It adds a
blacklisted
property with the value offalse
under thethreats
object in the API response.
Payment fraud endpoint
Payment fraud endpoint
- Overwrite score: Overwrites the
score
property value with the speicifed score value in the custom rule.
Email scoring endpoint
Email scoring endpoint
- Overwrite score: Overwrites the
score
property value with the speicifed score value in the custom rule. - Mark as valid: Marks the email address as valid. It overwrites the
isValid
property value totrue
. - Mark as invalid: Marks the email address as invalid. It overwrites the
isValid
property value tofalse
.
Phone number scoring endpoint
Phone number scoring endpoint
- Mark as valid: Marks the phone number as valid. It overwrites the
isValid
property value totrue
. - Mark as invalid: Marks the phone number as invalid. It overwrites the
isValid
property value tofalse
.
BIN lookup endpoint
BIN lookup endpoint
- Mark as valid: Marks the BIN as valid. It overwrites the
isValid
property value totrue
. - Mark as invalid: Marks the BIN as invalid. It overwrites the
isValid
property value tofalse
.
IBAN lookup endpoint
IBAN lookup endpoint
- Mark as valid: Marks the IBAN as valid. It overwrites the
isValid
property value totrue
. - Mark as invalid: Marks the IBAN as invalid. It overwrites the
isValid
property value tofalse
.