Error codes

Integrations

Changelog

Server Status

Articles

Greip API Documentation

API Reference

Knowledge Base

Packages & Libraries

Dashboard

Community

List of any error you might get while using Greip API

Error Codes

Introduction

Authentication

HTTPS Support

Usage Limits

Get exactly what you need for each request to Greip

Customize response modules

Get the response in the format you prefer

Response format

Get the response in your native language!

Localization

Test everything before releasing it to the production environment

Development environment

Identify source of the risk in your system!

User identifier

JSONP callback

VPN/Proxy detection

Webhooks

Obtaining an API Key

Protecting your API Key

Enable two-factor authentication for your account

Enabling 2FA

Manage the devices that are authorized to access your account

Manage authorized devices

Upgrading your account

Download your invoices from the dashboard

Downloading invoices

Keep track of your system events and alerts

Overview

Filter the events and alerts based on the event type, risk score, and time period

Filtering results

Export the events and alerts in CSV format

Exporting data

View the details of an event to get more information about it

Viewing event details

Subscription Usage Tracking

Real-time threat monitoring

Be part of our affiliate partners and earn commisions

Becoming Affiliate Partner

A guide to set up your affiliate account to be ready for receive payouts

Payout Settings

Integrate Greip with Slack to receive real-time alerts and notifications

Integrate Greip with Slack

Integrate Greip with over 2,000 apps and services using Zapier

Integrate Greip with Zapier

Integrate Greip with over 6500 apps and services using IFTTT

Integrate Greip with IFTTT

List of packages & libraries

Other resources

This API allows you to retrieve detailed geolocation information for a visitor’s or user’s IP address.

By using the IP Geolocation method, you can access data such as the user’s country, city, ISP, and more, enabling you to personalize user experiences, enhance security, and make data-driven decisions based on geographic insights.

IP Geolocation

Use this API to retrieve comprehensive information about a given IP address. It provides details such as location, ISP, and potential risk factors, enabling you to analyze and verify IP data for enhanced security, fraud prevention, and user profiling.

IP Lookup

This API enables you to retrieve information for multiple IP addresses in a single request.

By using the `/lookup/ip/bulk` method, you can efficiently gather data such as location, ISP, and risk factors for a batch of IPs, saving time and streamlining your workflow for large-scale analysis.

Bulk IP Lookup

This API method allows you to look up any given Autonomous System Number (ASN) and retrieve comprehensive data associated with it.

The information returned includes the ASN name, organization name, country, associated domain, contact email, phone number, total IPs, and a detailed list of all related routes (both IPv4 and IPv6). This functionality is essential for network analysis, troubleshooting, and understanding the infrastructure behind IP addresses.

ASN Lookup

This method enables you to validate International Bank Account Numbers (IBANs) and obtain essential information about the country associated with each IBAN.

By using this API, you can ensure that the IBANs are formatted correctly and gain insights into the banking institution, enhancing security and accuracy in financial transactions.

IBAN Lookup

Utilize this module to effortlessly retrieve comprehensive information associated with a debit or credit card.

The API provides details such as card type (debit or credit), scheme (Visa, Mastercard, etc.), brand (gold, platinum, etc.), and bank information.

This data is invaluable for various applications, including verifying customer payment details, detecting fraudulent transactions, and delivering personalized services to enhance user experiences. 

BIN/IIN Lookup

This method allows you to retrieve detailed information about a country by providing its country code in the request.

The API returns valuable data, such as the country’s name, capital, population, region, and other relevant attributes, enabling you to enrich your applications with geographic context and enhance user experiences.

Country Lookup

This method allows you to retrieve the IP address of your visitors or users without the need for an account or API key in Greip.

It’s a quick and easy way to access IP information, making it ideal for basic integrations or when you need to capture user IPs with minimal setup.

Free Get-IP

Access comprehensive threat intelligence data linked to a specific IP address. This endpoint provides insights into malicious activity, reputation scoring, and potential security risks associated with the IP address.

IP Reputation

This method provides an additional layer of validation for your system. While validating email syntax is important, it is not sufficient.

This method goes beyond syntax validation by checking the domain's validity, the availability of the Mail Service, detecting Disposable Email (Temporary Emails), etc. By utilising this method, you can ensure a more thorough validation process for email addresses.

Email Scoring

This method serves as an additional layer of protection in your system for validating phone numbers. It not only checks the syntax but also assesses the likelihood of the phone number being valid and operational.

By incorporating this scoring into your workflow, you can enhance fraud detection, reduce invalid inputs, and improve the overall quality of data captured.

Phone Number Scoring

This method helps safeguard your website or app by detecting offensive or inappropriate language in user inputs. By screening for profanity and other harmful content before it’s made public, you can maintain a positive user environment, protect your brand, and prevent abusive behavior on your platform.

Profanity Detection

Prevent financial losses and protect your business by deploying AI-powered modules that analyze transaction patterns in real-time.

This method helps identify and block suspicious activities, mitigating the risk of fraudulent payments and ensuring a secure experience for both you and your customers.

Code	Type	Description
101	`invalid_key`	The API Key is missing or invalid.
102	`inactive_user`	The API Key owner (the account) is inactive right now. Please contact the support team for more information.
103	`limit_reached`	You reached the limit of your plan for this month. Please change your account’s plan or wait this month to end.
104	`invalid_params`	Please check out the parms parameter’s value.
105	`plan_expired`	Your plan has expired. Renew the subscription to enable using the API.
106	`flood_detected`	Our system has detected too many requests at the same time. Kindly please try to slow down.
107	`invalid_callback_name`	The value of the callback parameter cannot be a function name.
108	`invalid_format`	The value of the format parameter is not a valid format. Use `JSON`, `XML` or `Newline`.
109	`callback_not_allowed`	You can use the callback feature only with the JSON format.
110	`invalid_language`	The value of the lang parameter is not a valid format. Use `EN`, `AR`, `FR`, `DE`, `ES`, `JA`, `ZH` or `RU`.
111	`invalid_mode`	The value of the mode parameter is not a valid format. Use test or live.
112	`invalid_ip`	The IP Address is not valid or empty.
113	`domain_not_whitelisted`	You are sending the request from a domain that is not the domain name you set in the API settings of your account’s dashboard.
114	`security_module_not_allowed`	You cannot use the security module in the free plan. Please upgrade your API plan to unlock this feature.
115	`generic_error`	An error occurred while processing your request. Please try again later.
116	`invalid_country_code`	The Country Code is invalid or not found.
117	`feature_not_available`	This feature is not available for your plan, please upgrade your plan first.
118	`invalid_phone_number`	The Phone Number is invalid or missing.
119	`invalid_email_address`	The Email Address is invalid or missing.
120	`invalid_bin_number`	The BIN number is invalid or missing.
121	`invalid_asn`	The AS Number you provided is empty or invalid.
122	`invalid_iban`	The IBAN is invalid or missing.
123	`invalid_userid`	The user identifier is invalid or too long.

Get Started

API Features

Error Codes

Error codes

Get Started

API Features

​Error codes

Error codes