Greip
App · 13 actions
Stop fraud and check who you are dealing with: locate and score IP addresses, look up card BINs, IBANs, networks and domains, validate emails and phone numbers, screen text for profanity, and score payments for fraud.
Actions
| Action | What it does |
|---|---|
| Delete user data | Permanently delete everything Greip stored about one person (their scored payments, IPs, emails, phone numbers and IBANs), for example to answer a data deletion request. |
| Detect profanity | Screen text for profanity and abusive language before it is published. |
| Look up AS number | Find who runs an autonomous system (a network on the internet): its owner, contact details, kind of network and the address blocks it owns. |
| Look up card BIN | Find the card network, card type, issuing bank and country behind the first digits of a card number. |
| Look up country | Get facts about a country: its name, capital, population, dialing code, internet domain and whether it is in the EU. |
| Look up domain | Check whether a domain is new, dangerous, disposable or set up properly for email (mail servers, SPF, DKIM, DMARC). |
| Look up IP address | Find where an IP address is (country, region, city, coordinates) and which network runs it. |
| Look up several IP addresses | Look up a list of IP addresses in one request. |
| Score email address | Check an email address goes beyond its spelling: whether its domain can receive mail, whether it is disposable, free or role-based, and an overall risk level with the reasons. |
| Score IP address | Rate how risky an IP address is, from 0 to 100, with a risk level (low, medium, high), a suggestion (accept, review, reject) and the signals behind it: VPN, proxy, Tor, bot, hosting or blocklist. |
| Score payment | Rate how likely a payment is to be fraud, from 0 to 100, with a suggestion (accept, review, reject) and the rules that flagged it. |
| Score phone number | Check whether a phone number is valid for its country, disposable or blocklisted, with its carrier and an overall risk level with the reasons. |
| Validate IBAN | Check that an IBAN is valid and find its country, currency and bank. |
Delete user data
Permanently delete everything Greip stored about one person (their scored payments, IPs, emails, phone numbers and IBANs), for example to answer a data deletion request. It cannot be undone, and Greip allows 3 a day.
Inputs
- Email, phone or customer ID
valuetextRequired - The email address, phone number or customer ID to delete data for.
Outputs
emails_deletednumber- Email check records deleted
ibans_deletednumber- IBAN check records deleted
ips_deletednumber- IP address records deleted
phone_numbers_deletednumber- Phone check records deleted
profanity_checks_deletednumber- Profanity check records deleted
total_deletednumber- All records deleted
transactions_deletednumber- Payment records deleted
valuetext- The email, phone number or customer ID whose data was deleted
Example output
{
"emails_deleted": 1,
"ibans_deleted": 10,
"ips_deleted": 4,
"phone_numbers_deleted": 1,
"profanity_checks_deleted": 3,
"total_deleted": 44,
"transactions_deleted": 25,
"value": "jane@example.com"
}Detect profanity
Screen text for profanity and abusive language before it is published. Returns a risk level (low, medium, high) and a suggestion (accept, review, reject).
Inputs
- Text
texttextRequired - The text to check, such as a comment or a username.
- Test mode
test_modetrue/false - Turn on to get made-up sample data without using any of your plan's requests. Use it to try a step out.Default:
false.
Outputs
recommendationtext- What Greip suggests: accept, review or reject
risk_leveltext- How much profanity the text has: low (none or mild), medium or high
Example output
{
"recommendation": "accept",
"risk_level": "low"
}Look up AS number
Find who runs an autonomous system (a network on the internet): its owner, contact details, kind of network and the address blocks it owns.
Inputs
- AS number
asntextRequired - The AS number, with or without the AS.
- Test mode
test_modetrue/false - Turn on to get made-up sample data without using any of your plan's requests. Use it to try a step out.Default:
false.
Outputs
asntext- The AS number, such as AS9112
country_codetext- Two-letter country code of the organization
created_attext- When it was registered
domaintext- The organization's domain
emailtext- The organization's contact email
ipv4_prefixeslist- IPv4 address blocks it owns, such as 62.3.160.0/19
ipv6_prefixeslist- IPv6 address blocks it owns
nametext- The network's short name
organizationtext- The organization that runs it
phonetext- The organization's contact phone number
prefix_countnumber- How many address blocks it owns in all
registrytext- The regional registry that issued it, such as RIPE
statustext- Registration status, such as ASSIGNED
typetext- What kind of network: isp, hosting, business, education or government
Example output
{
"asn": "AS9112",
"country_code": "PL",
"created_at": "2004-04-17T11:47:57Z",
"domain": "poznan.pl",
"email": "noc@man.poznan.pl",
"ipv4_prefixes": [
"150.254.0.0/16",
"62.3.160.0/19"
],
"ipv6_prefixes": [
"2001:808::/35"
],
"name": "POZMAN",
"organization": "Poznan Supercomputing and Networking Center",
"phone": "+48 61 8582010",
"prefix_count": 3,
"registry": "RIPE",
"status": "ASSIGNED",
"type": "education"
}Look up card BIN
Find the card network, card type, issuing bank and country behind the first digits of a card number. Only the first eight digits are ever sent, so a whole number can be pasted.
Inputs
- BIN
bin_numbertextRequired - The first 6 to 8 digits of the card number.
- Test mode
test_modetrue/false - Turn on to get made-up sample data without using any of your plan's requests. Use it to try a step out.Default:
false.
Outputs
bank_citytext- The bank's city
bank_nametext- The issuing bank
bank_phonetext- The bank's phone number
bank_urltext- The bank's website
bintext- The first digits of the card number that were looked up
brandtext- The card brand, such as Traditional
card_lengthslist- The card number lengths this network uses
card_typetext- debit, credit and so on
countrytext- The country of the issuing bank
country_codetext- Two-letter code of that country
currencytext- The card's currency code
is_blacklistedtrue/false- True when the BIN is on your Greip blocklist
is_commercialtrue/false- True for a business card, when Greip knows
is_prepaidtrue/false- True for a prepaid card, when Greip knows
is_validtrue/false- True when the digits look like a real card number prefix
reasontext- Why it is not valid, when it is not. Empty otherwise
schemetext- The card network, such as Visa or Mastercard
security_code_lengthnumber- How many digits the security code has
security_code_nametext- What the security code is called, such as CVV
Example output
{
"bank_city": "Riyadh",
"bank_name": "AL RAJHI BANKING AND INVESTMENT CORP.",
"bank_phone": "+96611211600",
"bank_url": "https://www.alrajhibank.com.sa",
"bin": "456789",
"brand": "Traditional",
"card_lengths": [
16,
18,
19
],
"card_type": "debit",
"country": "Saudi Arabia",
"country_code": "SA",
"currency": "SAR",
"is_blacklisted": false,
"is_commercial": false,
"is_prepaid": false,
"is_valid": true,
"reason": "",
"scheme": "Visa",
"security_code_length": 3,
"security_code_name": "CVV"
}Look up country
Get facts about a country: its name, capital, population, dialing code, internet domain and whether it is in the EU. Add language, currency or flag as needed.
Inputs
- Country code
country_codetextRequired - The two-letter ISO country code.
- Extra details
moduleslist - More to include besides the basic facts.One or more of:
language,currency,flag. - Test mode
test_modetrue/false - Turn on to get made-up sample data without using any of your plan's requests. Use it to try a step out.Default:
false.
Outputs
capitaltext- The capital city
continenttext- The continent it is in
continent_codetext- Two-letter code of the continent
countrytext- The country's name
country_codetext- Two-letter country code
currencyobject- The currency: name, code and symbol. Empty unless asked for
dialing_codetext- International dialing code, without the +
flagobject- The flag as an emoji and as image links. Empty unless asked for
is_eutrue/false- True for a member of the European Union
languageobject- The main language: name, code and native name. Empty unless asked for
neighbourstext- Codes of neighbouring countries, separated by commas
populationnumber- How many people live there
top_level_domaintext- The country's internet domain, such as .us
Example output
{
"capital": "Washington, D.C.",
"continent": "North America",
"continent_code": "NA",
"country": "United States",
"country_code": "US",
"currency": {
"code": "USD",
"name": "United States Dollar",
"symbol": "$"
},
"dialing_code": "1",
"flag": {
"emoji": "US",
"svg": "https://greip.io/img/flags/svg/us.svg"
},
"is_eu": false,
"language": {
"code": "en",
"name": "English",
"native": "English"
},
"neighbours": "CA,MX,PM",
"population": 331002651,
"top_level_domain": ".us"
}Look up domain
Check whether a domain is new, dangerous, disposable or set up properly for email (mail servers, SPF, DKIM, DMARC). A domain Greip has not seen yet comes back empty and is collected for the next day.
Inputs
- Domain
domaintextRequired - The domain name. A pasted web address is cut down to its domain.
- Test mode
test_modetrue/false - Turn on to get made-up sample data without using any of your plan's requests. Use it to try a step out.Default:
false.
Outputs
created_attext- When it was registered
domaintext- The domain looked up
has_bimitrue/false- True when it publishes a BIMI record
has_dkimtrue/false- True when it publishes a DKIM record
has_dmarctrue/false- True when it publishes a DMARC policy
has_mxtrue/false- True when it has mail servers, so it can receive email
has_spftrue/false- True when it publishes an SPF record
is_dangeroustrue/false- True when Greip flags the domain as dangerous or suspicious
is_disposabletrue/false- True for a domain used for throwaway email
is_forwardingtrue/false- True for an email forwarding service
is_newtrue/false- True when it was registered within the last year
Example output
{
"created_at": "2025-02-05",
"domain": "dangerous-domain.com",
"has_bimi": false,
"has_dkim": false,
"has_dmarc": false,
"has_mx": false,
"has_spf": false,
"is_dangerous": true,
"is_disposable": false,
"is_forwarding": false,
"is_new": true
}Look up IP address
Find where an IP address is (country, region, city, coordinates) and which network runs it. Add Security to see whether it is a VPN, proxy, Tor exit node or hosting provider.
Inputs
- IP address
ip_addresstextRequired - The IPv4 or IPv6 address to look up.
- Extra details
moduleslist - More to include besides the location and network. Security (VPN, proxy and Tor detection) needs a paid Greip plan.One or more of:
security(Security (VPN, proxy, Tor, bot, hosting)),location(Country details (capital, flag, languages)),currency,timezone(Time zone and sunrise),device(Device (browser and operating system)). - Language
languagetext - The language of place names. Defaults to English.One of:
EN(English (default)),AR(Arabic),DE(German),ES(Spanish),FR(French),JA(Japanese),RU(Russian),ZH(Chinese). - Test mode
test_modetrue/false - Turn on to get made-up sample data without using any of your plan's requests. Use it to try a step out.Default:
false.
Outputs
asntext- The network's AS number, such as AS14061
asn_nametext- The network's short name
asn_organizationtext- The company that runs the network
asn_typetext- What kind of network: isp, hosting, business, education or government
citytext- The city
continenttext- The continent it is in
continent_codetext- Two-letter code of the continent, such as EU
countrytext- The country it is in
country_codetext- Two-letter code of the country, such as DE
currencyobject- The country's currency name, code and symbol. Empty unless asked for
deviceobject- Browser, operating system and device type. Empty unless asked for
ip_addresstext- The address looked up
ip_versionnumber- 4 or 6
is_bogontrue/false- True for a private or reserved address that no one can reach
is_hostingtrue/false- True for a hosting or cloud provider. Empty unless Security details were asked for
is_tortrue/false- True for a Tor exit node. Empty unless Security details were asked for
is_vpn_or_proxytrue/false- True for a VPN or proxy. Empty unless Security details were asked for
latitudenumber- Latitude of the location
locationobject- Country details such as capital, population, languages and flag. Empty unless asked for
longitudenumber- Longitude of the location
postal_codetext- The postal or ZIP code
regiontext- The region or state
securityobject- All security checks (VPN, proxy, Tor, bot, relay, hosting, blocklist). Empty unless asked for
timezoneobject- Time zone name, offset, local time and sun times. Empty unless asked for
Example output
{
"asn": "AS14061",
"asn_name": "DIGITALOCEAN-ASN",
"asn_organization": "DigitalOcean, LLC",
"asn_type": "hosting",
"city": "Frankfurt am Main",
"continent": "Europe",
"continent_code": "EU",
"country": "Germany",
"country_code": "DE",
"currency": {
"code": "EUR",
"name": "Euro",
"symbol": "EUR"
},
"device": {
"type": "desktop"
},
"ip_address": "165.227.149.217",
"ip_version": 4,
"is_bogon": false,
"is_hosting": true,
"is_tor": false,
"is_vpn_or_proxy": true,
"latitude": 50.11552,
"location": {
"capital": "Berlin",
"is_eu": true,
"population": 83783942
},
"longitude": 8.68417,
"postal_code": "65931",
"region": "Hessen",
"security": {
"hosting": true,
"tor": false,
"vpn_or_proxy": true,
"vpn_or_proxy_type": "VPN"
},
"timezone": {
"abbreviation": "CET",
"name": "Europe/Berlin",
"offset": 3600
}
}Look up several IP addresses
Look up a list of IP addresses in one request. Greip reads about 10 IPv4 addresses at a time (159 characters). Invalid and repeated addresses are skipped.
Inputs
- IP addresses
ip_addresseslistRequired - The addresses to look up: a list from an earlier step, or addresses separated by commas or new lines.
- Extra details
moduleslist - More to include besides the location and network. Security (VPN, proxy and Tor detection) needs a paid Greip plan.One or more of:
security(Security (VPN, proxy, Tor, bot, hosting)),location(Country details (capital, flag, languages)),currency,timezone(Time zone and sunrise),device(Device (browser and operating system)). - Language
languagetext - The language of place names. Defaults to English.One of:
EN(English (default)),AR(Arabic),DE(German),ES(Spanish),FR(French),JA(Japanese),RU(Russian),ZH(Chinese). - Test mode
test_modetrue/false - Turn on to get made-up sample data without using any of your plan's requests. Use it to try a step out.Default:
false.
Outputs
countnumber- How many addresses were looked up
resultslist- One entry per address Greip looked up
skippedlist- Addresses Greip left out of its answer
Example output
{
"count": 1,
"results": [
{
"asn": "AS14061",
"asn_name": "DIGITALOCEAN-ASN",
"asn_organization": "DigitalOcean, LLC",
"asn_type": "hosting",
"city": "Frankfurt am Main",
"continent": "Europe",
"continent_code": "EU",
"country": "Germany",
"country_code": "DE",
"currency": {
"code": "EUR",
"name": "Euro",
"symbol": "EUR"
},
"device": {
"type": "desktop"
},
"ip_address": "165.227.149.217",
"ip_version": 4,
"is_bogon": false,
"is_hosting": true,
"is_tor": false,
"is_vpn_or_proxy": true,
"latitude": 50.11552,
"location": {
"capital": "Berlin",
"is_eu": true,
"population": 83783942
},
"longitude": 8.68417,
"postal_code": "65931",
"region": "Hessen",
"security": {
"hosting": true,
"tor": false,
"vpn_or_proxy": true,
"vpn_or_proxy_type": "VPN"
},
"timezone": {
"abbreviation": "CET",
"name": "Europe/Berlin",
"offset": 3600
}
}
],
"skipped": [
"10.0.0.1"
]
}Score email address
Check an email address goes beyond its spelling: whether its domain can receive mail, whether it is disposable, free or role-based, and an overall risk level with the reasons.
Inputs
- Email address
emailtextRequired - The email address to check.
- Test mode
test_modetrue/false - Turn on to get made-up sample data without using any of your plan's requests. Use it to try a step out.Default:
false.
Outputs
domainobject- What Greip found about the domain: age, mail servers, SPF, DMARC and so on
emailtext- The address scored
is_blacklistedtrue/false- True when the address or its domain is on your Greip blocklist
is_disposabletrue/false- True for a throwaway address
is_educationaltrue/false- True for a school or university address
is_freetrue/false- True for a free provider such as Gmail
is_role_basedtrue/false- True for a shared address such as info@ or support@
is_validtrue/false- True when the address is well formed. This says nothing about risk: use the risk level
reasonslist- Why the risk is above low, in words. Empty when it is low
recommendationtext- What Greip suggests: accept, review or reject
risk_leveltext- How risky it looks: low, medium or high
ruleslist- The checks that fired, each with a code and a description. Empty when none did
Example output
{
"domain": {
"is_dangerous": true,
"is_new": true,
"name": "dangerous-domain.com"
},
"email": "test@dangerous-domain.com",
"is_blacklisted": false,
"is_disposable": false,
"is_educational": false,
"is_free": false,
"is_role_based": true,
"is_valid": false,
"reasons": [
"Email domain is considered dangerous."
],
"recommendation": "reject",
"risk_level": "high",
"rules": [
{
"description": "Email domain is considered dangerous.",
"id": "EMAIL_DANGEROUS_DOMAIN"
}
]
}Score IP address
Rate how risky an IP address is, from 0 to 100, with a risk level (low, medium, high), a suggestion (accept, review, reject) and the signals behind it: VPN, proxy, Tor, bot, hosting or blocklist.
Inputs
- IP address
ip_addresstextRequired - The IPv4 or IPv6 address to score.
- Test mode
test_modetrue/false - Turn on to get made-up sample data without using any of your plan's requests. Use it to try a step out.Default:
false.
Outputs
ip_addresstext- The address scored
is_blacklistedtrue/false- True when it is on your Greip blocklist
is_bottrue/false- True when the traffic looks automated
is_hostingtrue/false- True for a hosting or cloud provider
is_relaytrue/false- True for Apple Private Relay or a similar service
is_tortrue/false- True for a Tor exit node
is_vpn_or_proxytrue/false- True for a VPN or proxy
recommendationtext- What Greip suggests: accept, review or reject
risk_leveltext- How risky it looks: low, medium or high
ruleslist- The checks that fired, each with a code and a description. Empty when none did
scorenumber- Threat score from 0 to 100. Higher is riskier
vpn_or_proxy_typetext- The kind of VPN or proxy, such as VPN or Socks
Example output
{
"ip_address": "12.12.12.12",
"is_blacklisted": false,
"is_bot": false,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_vpn_or_proxy": true,
"recommendation": "review",
"risk_level": "medium",
"rules": [
{
"description": "IP address is associated with VPN, proxy, or anonymization service.",
"id": "IP_VPN_OR_PROXY"
},
{
"description": "IP address belongs to hosting or cloud provider ASN.",
"id": "IP_HOSTING"
}
],
"score": 35,
"vpn_or_proxy_type": "Socks"
}Score payment
Rate how likely a payment is to be fraud, from 0 to 100, with a suggestion (accept, review, reject) and the rules that flagged it. Fill in whatever you know: the more you give, the more rules Greip can check.
Inputs
- What the customer is doing
payment_actiontext - Purchase, deposit or withdrawal. Defaults to purchase.One of:
purchase(Purchase (default)),deposit,withdrawal. - Transaction ID
transaction_idtext - Your own ID for the payment.
- Amount
transaction_amountnumber - The total amount of the payment.At least 0.
- Currency
transaction_currencytext - The three-letter currency code the customer pays in.
- Payment method
payment_typetext - How the customer pays.One of:
cards(Card),cards_mada(mada card),applepay(Apple Pay),stcpay(STC Pay),bank(Bank transfer),crypto,wallet,cod(Cash on delivery). - Customer ID
customer_idtext - Your own ID for the customer. With it, Greip also reports how often the same IP, email and phone were scored.
- Customer email
customer_emailtext - The customer's email address.
- Customer phone
customer_phonetext - The customer's phone number, in international format.
- Customer IP address
customer_iptext - The IP address the customer is paying from.
- Customer browser
customer_useragenttext - The customer's user agent text.
- Customer country
customer_countrytext - Two-letter code of the country the customer lives in.
- Billing country
billing_countrytext - Two-letter code of the billing address's country.
- Shipping country
shipping_countrytext - Two-letter code of the shipping address's country.
- Customer registered
customer_registration_datedate and time - When the customer created their account.
- Card number or BIN
card_numbertext - The first 6 to 8 digits of the card number are enough. Only the first eight digits are ever sent.
- CVV check passed
cvv_resulttrue/false - Turn on when the customer passed the CVV check. Left off, Greip is not told either way.Default:
false. - Uses two-factor sign-in
customer_2fatrue/false - Turn on when the customer has two-factor sign-in on their account.Default:
false. - Digital products
is_digital_productstrue/false - Turn on when the customer is buying digital products.Default:
false. - Coupon code
coupontext - The promo code the customer used.
- Website domain
website_domaintext - The domain the customer is buying from.
- Merchant ID
merchant_idtext - For a platform with many shops: the ID of the shop being bought from.
- Additional details
additional_dataobject - Any other detail Greip reads, by its name, such as customer_city, billing_zip or shipping_street.
- Test mode
test_modetrue/false - Turn on to get made-up sample data without using any of your plan's requests. Use it to try a step out.Default:
false.
Outputs
recommendationtext- What Greip suggests: accept, review or reject
risk_leveltext- How risky it looks: low, medium or high
ruleslist- The checks that fired, each with a code and a description. Empty when none did
rules_checkednumber- How many rules Greip checked
rules_detectednumber- How many of them fired
scorenumber- Fraud risk from 0 to 100: 10.5 means a 10.5% chance the payment is risky
velocityobject- How often the same IP, email or phone was scored in the last day and week. Empty without a customer ID
Example output
{
"recommendation": "review",
"risk_level": "high",
"rules": [
{
"description": "Customer IP Address is probably VPN/Proxy/Bot/Hosting/Cloud.",
"id": "PF10003"
}
],
"rules_checked": 21,
"rules_detected": 6,
"score": 82,
"velocity": {
"email_24h_count": 1,
"ip_24h_count": 4,
"ip_7d_count": 12
}
}Score phone number
Check whether a phone number is valid for its country, disposable or blocklisted, with its carrier and an overall risk level with the reasons.
Inputs
- Phone number
phone_numbertextRequired - The number, with or without the country code.
- Country code
country_codetextRequired - The two-letter ISO code of the number's country.
- Test mode
test_modetrue/false - Turn on to get made-up sample data without using any of your plan's requests. Use it to try a step out.Default:
false.
Outputs
carriertext- The carrier, when Greip knows it
country_codetext- The country code it was checked against
is_blacklistedtrue/false- True when the number is on your Greip blocklist
is_disposabletrue/false- True for a disposable or spam number
is_validtrue/false- True when the number is valid for that country
phonetext- The number scored
reasonslist- Why the risk is above low, in words. Empty when it is low
recommendationtext- What Greip suggests: accept, review or reject
risk_leveltext- How risky it looks: low, medium or high
Example output
{
"carrier": "Verizon",
"country_code": "US",
"is_blacklisted": false,
"is_disposable": false,
"is_valid": false,
"phone": "+12121234567",
"reasons": [
"Invalid phone number structure."
],
"recommendation": "reject",
"risk_level": "high"
}Validate IBAN
Check that an IBAN is valid and find its country, currency and bank. An invalid IBAN is an answer, not an error: is_valid is false.
Inputs
- IBAN
ibantextRequired - The IBAN, with or without spaces.
- Test mode
test_modetrue/false - Turn on to get made-up sample data without using any of your plan's requests. Use it to try a step out.Default:
false.
Outputs
bank_bictext- The bank's BIC or SWIFT code, when Greip knows it
bank_nametext- The bank, when Greip knows it
central_banktext- The country's central bank
countrytext- The country the IBAN is from
country_codetext- Two-letter code of that country
currencytext- That country's currency code
formattedtext- The IBAN in groups of four, as people write it
ibantext- The IBAN without spaces
is_eutrue/false- True for a country in the European Union
is_sepatrue/false- True for a country in the Single Euro Payments Area
is_validtrue/false- True when the IBAN is valid
maskedtext- The IBAN with the middle hidden, safe to show
Example output
{
"bank_bic": "GEBABEBB",
"bank_name": "BNP Paribas Fortis",
"central_bank": "National Bank of Belgium",
"country": "Belgium",
"country_code": "BE",
"currency": "EUR",
"formatted": "BE71 0961 2345 6769",
"iban": "BE71096123456769",
"is_eu": true,
"is_sepa": true,
"is_valid": true,
"masked": "BE** **** **** 6769"
}