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.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.