Introduction

Gurdx is a fraud-prevention and user-intelligence API that scores IP addresses, emails, phone numbers, cards, IBANs and payments in a single JSON call.

What Gurdx does#

Gurdx helps you decide, in real time, whether a visitor or a transaction deserves your trust. You send a value (an IP address, an email, a BIN, a payment, a piece of text) and Gurdx answers with structured data and, where it makes sense, a risk score you can act on.

Every method shares the same paths convention, response envelope and numbered error codes, so one client works for the whole API. Start with the API reference.

Base URL#

All requests go to:

https://gurdx.cretip.com/api

Every endpoint is reachable over HTTPS only. See HTTPS.

Your first request#

Create an API key in the dashboard (https://gurdx.cretip.com/app), then call the IP geolocation endpoint:

curl "https://gurdx.cretip.com/api/geoip?key=YOUR_API_KEY"

When no ip parameter is given, Gurdx looks up the address the request came from. A successful response looks like this:

{
  "data": {
    "ip": "203.0.113.7",
    "countryCode": "SA",
    "countryName": "Saudi Arabia"
  },
  "status": "success",
  "executionTime": 12
}

executionTime is the processing time in milliseconds.

Available endpoints#

Each method has its own page in the API reference, for example IP Lookup and Payment Fraud Detection.

Response shape#

• Success: {"data": {...}, "status": "success", "executionTime": 12}.
• Failure: {"status": "error", "code": 101, "type": "invalid_key", "description": "..."}.

Errors are returned with HTTP status 200. Always check the status field of the body instead of relying on the HTTP status. The full list is on Error codes.

Options common to every method#

Where to go next#

1. Authentication and API keys.
2. Usage limits for your plan.
3. Error codes and how to handle them.