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

ActionWhat it does
Delete user dataPermanently 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 profanityScreen text for profanity and abusive language before it is published.
Look up AS numberFind 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 BINFind the card network, card type, issuing bank and country behind the first digits of a card number.
Look up countryGet facts about a country: its name, capital, population, dialing code, internet domain and whether it is in the EU.
Look up domainCheck whether a domain is new, dangerous, disposable or set up properly for email (mail servers, SPF, DKIM, DMARC).
Look up IP addressFind where an IP address is (country, region, city, coordinates) and which network runs it.
Look up several IP addressesLook up a list of IP addresses in one request.
Score email addressCheck 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 addressRate 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 paymentRate 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 numberCheck whether a phone number is valid for its country, disposable or blocklisted, with its carrier and an overall risk level with the reasons.
Validate IBANCheck 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 IDvaluetextRequired
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

TexttexttextRequired
The text to check, such as a comment or a username.
Test modetest_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 numberasntextRequired
The AS number, with or without the AS.
Test modetest_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

BINbin_numbertextRequired
The first 6 to 8 digits of the card number.
Test modetest_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 codecountry_codetextRequired
The two-letter ISO country code.
Extra detailsmoduleslist
More to include besides the basic facts.One or more of: language, currency, flag.
Test modetest_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

DomaindomaintextRequired
The domain name. A pasted web address is cut down to its domain.
Test modetest_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 addressip_addresstextRequired
The IPv4 or IPv6 address to look up.
Extra detailsmoduleslist
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)).
Languagelanguagetext
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 modetest_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 addressesip_addresseslistRequired
The addresses to look up: a list from an earlier step, or addresses separated by commas or new lines.
Extra detailsmoduleslist
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)).
Languagelanguagetext
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 modetest_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 addressemailtextRequired
The email address to check.
Test modetest_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 addressip_addresstextRequired
The IPv4 or IPv6 address to score.
Test modetest_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 doingpayment_actiontext
Purchase, deposit or withdrawal. Defaults to purchase.One of: purchase (Purchase (default)), deposit, withdrawal.
Transaction IDtransaction_idtext
Your own ID for the payment.
Amounttransaction_amountnumber
The total amount of the payment.At least 0.
Currencytransaction_currencytext
The three-letter currency code the customer pays in.
Payment methodpayment_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 IDcustomer_idtext
Your own ID for the customer. With it, Greip also reports how often the same IP, email and phone were scored.
Customer emailcustomer_emailtext
The customer's email address.
Customer phonecustomer_phonetext
The customer's phone number, in international format.
Customer IP addresscustomer_iptext
The IP address the customer is paying from.
Customer browsercustomer_useragenttext
The customer's user agent text.
Customer countrycustomer_countrytext
Two-letter code of the country the customer lives in.
Billing countrybilling_countrytext
Two-letter code of the billing address's country.
Shipping countryshipping_countrytext
Two-letter code of the shipping address's country.
Customer registeredcustomer_registration_datedate and time
When the customer created their account.
Card number or BINcard_numbertext
The first 6 to 8 digits of the card number are enough. Only the first eight digits are ever sent.
CVV check passedcvv_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-incustomer_2fatrue/false
Turn on when the customer has two-factor sign-in on their account.Default: false.
Digital productsis_digital_productstrue/false
Turn on when the customer is buying digital products.Default: false.
Coupon codecoupontext
The promo code the customer used.
Website domainwebsite_domaintext
The domain the customer is buying from.
Merchant IDmerchant_idtext
For a platform with many shops: the ID of the shop being bought from.
Additional detailsadditional_dataobject
Any other detail Greip reads, by its name, such as customer_city, billing_zip or shipping_street.
Test modetest_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 numberphone_numbertextRequired
The number, with or without the country code.
Country codecountry_codetextRequired
The two-letter ISO code of the number's country.
Test modetest_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

IBANibantextRequired
The IBAN, with or without spaces.
Test modetest_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"
}

On this page