API v2DocumentationAuthentication
Greip API v2
Greip API v2 is available athttps://v2.greipapi.com and is the recommended version for new integrations. Your existing API key and plan work on v2. API v1 remains supported on https://greipapi.com for existing integrations.Compared with v1, v2 uses a dedicated host, updated URL paths, Bearer-only authentication, and a consistent JSON response format (snake_case fields, a boolean success flag, and execution_ms). Request and response shapes for geo, scoring, and related endpoints are aligned with the v2 API reference.For endpoint-by-endpoint differences, field mappings, and an upgrade checklist, see the Migrate from API v1 to v2 guide on docs.greip.io. The API reference there defaults to API v2.cidrfield added to the optionalasnobject on IP Geolocation API and IP Lookup API (API v2). The value is the longest matching network prefix (CIDR) for the IP on the resolved ASN, ornullwhen no match is found.
Domain LookupEmail Scoring
is_disposablefield added to Domain Lookup API response, indicating whether a domain is associated with disposable email services. You’ll also find this field in the Email Scoring API response.is_forwardingfield added to Domain Lookup API response, indicating whether a domain is associated with email forwarding services. This field is also included in the Email Scoring API response.
BIN LookupASN Lookup
- EBT card detection added to BIN Lookup API.
- ASN Lookup API now returns prefixes.
Email ScoringProfanity Detection
- Education email detection added to Email Scoring API.
- Profanity detection API in now uses machine learning algorithms for improved accuracy.
Email ScoringDomain Lookup
- Comprehensive domain data is now included in the Email Scoring API.
- Launched a new Domain Lookup API to retrieve detailed information about domains, including creation date and risk evaluation metrics.
Performance
- Major Performance Improvements for all other APIs!
Phone Number ScoringBIN Lookup
- Phone Number Scoring API now detects disposable phone numbers.
- Improved card currency detection algorithm in BIN Lookup API.
BIN Lookup
- Card brand detection algorithm updated to improve accuracy and reliability when identifying card brands based on BIN data.
Customizations
- Custom Rules feature is just released! You can now create your own custom rules to tailor Greip’s fraud detection capabilities to your specific needs.
- Blacklists feature is now live! You can create and manage blacklists to block specific data points.
Email ScoringCompliancePayment Fraud Detection
- Disposable email detection added to Email Scoring API.
- User Data Deletion Endpoint now available! It allows you to delete user data in compliance with data protection regulations.
- Our Payment Fraud Detection API got a major upgrade to the detection algorithms!
- Email Scoring API now detects role-based emails! And more improvements to the scoring algorithm.
Error HandlingIP GeolocationBIN LookupPerformance
- Improved error handling across all APIs for better reliability and user experience.
- Bogon IP detection added to IP Geolocation API and IP Lookup API.
- Luhn algorithm check enhanced in BIN Lookup API.
- User agent appended to the response of IP Geolocation API.
- Major performance improvements for all APIs.
IP GeolocationCountry Lookup
- Country flags’ URLs enhanced in IP Geolocation API, IP Lookup API and Country Lookup API.
Performance
- Major performance improvements for all APIs.
IP ScoringPerformanceAuthentication
- IP Scoring API is now live! You can now assess the risk level of IP addresses to help identify potentially fraudulent activity.
- The ability to authenticate using Bearer tokens has been added for improved security.
- Major performance improvements for all APIs.