Zum Inhalt springen
LOX24 API Docs

Liste der Anti-Betrugs Abfragen

GET
/fraud-checks

Fragt die Liste aller bisherigen Anfragen an die Fraud Detection API ab

Authorizations

Abschnitt betitelt „Authorizations “

Parameters

Abschnitt betitelt „ Parameters “

Query Parameters

Abschnitt betitelt „Query Parameters “
page
integer
default: 1 >= 1 <= 1000000

Aktuelle Seite

_order[created_at]

Sort order direction (ascending or descending)

string
default: asc
Allowed values: asc desc

Sortierung nach Zeitstempel, wann die Entität erstellt wurde

id

Eindeutige Entitäts-UUID

string
/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/

Exact Filter nach der ID der Betrugsanfrage

id[]
Array<string>

Exact Filter nach den Betrugsanfrage-IDs

callback_data

Wert (String) welcher an Ihren Endpoint zurückgeschickt wird. Sie können z.B. Ihre eigene ID so übergeben und mit dem Zustellbericht (DLR) zurückbekommen.

string | null
<= 36 characters

Einmalige Filterung von Entitäten durch die callback_data

request_phone.phone
string
>= 1 characters <= 16 characters /^\+?[1-9]\d{0,14}$/

Partial Filter nach dem Telefonwert der Anfrage

request_email.email
string
>= 1 characters <= 500 characters

Partial Filter nach dem E-Mail-Wert der Anfrage

request_ip.ip
string
>= 1 characters <= 39 characters

Partial Filter nach dem IP-Wert der Anfrage

status_code

Statuscodes der Anfrageverarbeitung:

  • 0 – neue Anfrage und noch nicht bearbeitet
  • 5 – Anfrage in Bearbeitung
  • 10 – Verarbeitung der Abfrage erfolgreich abgeschlossen
  • 20 - Verarbeitung mit Fehler abgeschlossen: nicht genug Guthaben/Kreditlinie
  • 21 - Verarbeitung mit Fehler abgeschlossen: ungültige Daten
  • 1000 - Verarbeitung mit Fehler abgeschlossen: unerwarteter Fehler
integer
Allowed values: 0 5 10 20 21 1000

Exact Filter von Betrugsanfragen nach dem Statuscode

status_code[]
Array<integer>
Allowed values: 0 5 10 20 21 1000

Exact Filter von Betrugsanfragen nach den Statuscodes

Responses

Abschnitt betitelt „ Responses “

200

Abschnitt betitelt „200 “

Fraud-check collection

object
member
required
Array<object>

Fraud check request

object
@id

JSON-LD ID

string
@type

JSON-LD type

string
@context
One of:
string
id

Eindeutige Entitäts-UUID

string
/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/
status_code

Statuscodes der Anfrageverarbeitung:

  • 0 – neue Anfrage und noch nicht bearbeitet
  • 5 – Anfrage in Bearbeitung
  • 10 – Verarbeitung der Abfrage erfolgreich abgeschlossen
  • 20 - Verarbeitung mit Fehler abgeschlossen: nicht genug Guthaben/Kreditlinie
  • 21 - Verarbeitung mit Fehler abgeschlossen: ungültige Daten
  • 1000 - Verarbeitung mit Fehler abgeschlossen: unerwarteter Fehler
integer
Allowed values: 0 5 10 20 21 1000
risk_score

Betrugsrisiko-Score von 0 (gut) bis 100 (schlecht)

number
<= 100
service_code
required

Der Servicecode bestimmt die Art der Betrugsabfrage, die Sie durchführen. economy enthält nur einen Risikowert, während pro und direct mehr Details zu den Ergebnissen enthalten, so dass Sie Ihre eigene Entscheidung treffen können. direct Abfragen werden ebenfalls mit Priorität bearbeitet. (siehe /me)

string
Allowed values: economy pro direct
created_at

Zeitstempel, wann die Entität vom Benutzer zum System hinzugefügt wurde

integer
updated_at

Zeitstempel, wann die Entität geändert wurde

integer
callback_data
Any of:

Wert (String) welcher an Ihren Endpoint zurückgeschickt wird. Sie können z.B. Ihre eigene ID so übergeben und mit dem Zustellbericht (DLR) zurückbekommen.

string | null
<= 36 characters
request_phone
Any of:

Fraud check request phone number

object
@id

JSON-LD ID

string
@type

JSON-LD type

string
@context
One of:
string
status_code

Statuscodes der Anfrageverarbeitung:

  • 0 – neue Anfrage und noch nicht bearbeitet
  • 5 – Anfrage in Bearbeitung
  • 10 – Verarbeitung der Abfrage erfolgreich abgeschlossen
  • 20 - Verarbeitung mit Fehler abgeschlossen: nicht genug Guthaben/Kreditlinie
  • 21 - Verarbeitung mit Fehler abgeschlossen: ungültige Daten
  • 1000 - Verarbeitung mit Fehler abgeschlossen: unerwarteter Fehler
integer
Allowed values: 0 5 10 20 21 1000
phone
required

Zielrufnummer:

  • +491701234567 (E.164)
  • 00491701234567
  • 491701234567
  • 01701234567 (wenn Ihr Account in Deutschland registriert ist) wird es konvertiert zu +491701234567

Wenn Sie Ihre Rufnummer nicht im E.164 Format übertragen, versucht unser System die Rufnummer anhand Ihres Firmensitzes aus Ihren Profildaten in E.164 Format zu konvertieren. Um Probleme bei der automatischen Konvertierung zu vermeiden, nutzen Sie bitte bevorzugt das E.164 Format.

string
>= 7 characters <= 16 characters /^\+[1-9]\d{1,14}$/
created_at

Zeitstempel, wann die Entität vom Benutzer zum System hinzugefügt wurde

integer
updated_at

Zeitstempel, wann die Entität geändert wurde

integer
is_possible

Telefonnummer theoretisch möglich

boolean
is_valid

Telefonnummer gültig

boolean
region

Ländercode

string
>= 2 characters <= 2 characters /^[A-Z]{2}$/
number_type

Rufnummerntyp

string
request_email
Any of:

Fraud check request email

object
@id

JSON-LD ID

string
@type

JSON-LD type

string
@context
One of:
string
status_code

Statuscodes der Anfrageverarbeitung:

  • 0 – neue Anfrage und noch nicht bearbeitet
  • 5 – Anfrage in Bearbeitung
  • 10 – Verarbeitung der Abfrage erfolgreich abgeschlossen
  • 20 - Verarbeitung mit Fehler abgeschlossen: nicht genug Guthaben/Kreditlinie
  • 21 - Verarbeitung mit Fehler abgeschlossen: ungültige Daten
  • 1000 - Verarbeitung mit Fehler abgeschlossen: unerwarteter Fehler
integer
Allowed values: 0 5 10 20 21 1000
email
required

E-Mail Adresse

More information

string format: email
>= 6 characters <= 500 characters
created_at

Zeitstempel, wann die Entität vom Benutzer zum System hinzugefügt wurde

integer
updated_at

Zeitstempel, wann die Entität geändert wurde

integer
is_possible

E-Mail möglich

boolean
is_anonymous

Wird der Dienst zur Anonymisierung des Absenders der E-Mail verwendet

boolean
request_ip
Any of:

Fraud check request IP address

object
@id

JSON-LD ID

string
@type

JSON-LD type

string
@context
One of:
string
status_code

Statuscodes der Anfrageverarbeitung:

  • 0 – neue Anfrage und noch nicht bearbeitet
  • 5 – Anfrage in Bearbeitung
  • 10 – Verarbeitung der Abfrage erfolgreich abgeschlossen
  • 20 - Verarbeitung mit Fehler abgeschlossen: nicht genug Guthaben/Kreditlinie
  • 21 - Verarbeitung mit Fehler abgeschlossen: ungültige Daten
  • 1000 - Verarbeitung mit Fehler abgeschlossen: unerwarteter Fehler
integer
Allowed values: 0 5 10 20 21 1000
ip
required

IP-Adresse (IP v4/v6)

string
>= 7 characters <= 39 characters
created_at

Zeitstempel, wann die Entität vom Benutzer zum System hinzugefügt wurde

integer
updated_at

Zeitstempel, wann die Entität geändert wurde

integer
iso2

Ländercode

string
>= 2 characters <= 2 characters /^[A-Z]{2}$/
state

Bundesland oder Region der IP-Adresse

string
city

Stadt der IP-Adresse

string
postcode

PLZ der IP-Adresse

string
geolocation

Der Breitengrad und Längengrad der IP-Adresse (array)

Array<number>
isp_name

Der Name des des Internet Service Providers (ISP)

string
isp_risk_score

Risikofaktor für ISP

number
<= 100
proxy_type

Wenn der Host ein Proxy ist:

  • VPN – Anonymisierende VPN-Dienste. Diese Dienste bieten Nutzern ein öffentlich zugängliches VPN an, um ihre IP-Adresse zu verbergen.
  • TOR – Tor-Ausgangsknoten. Das Tor-Projekt ist ein offenes Netzwerk, das von denjenigen genutzt wird, die Anonymität wahren wollen.
  • DCH – Hosting-Anbieter, Datenzentrum oder Content Delivery Network. Da Hosting-Provider und Datenzentren dazu dienen können, Anonymität zu gewährleisten, kennzeichnet die Anonymous-IP-Datenbank IP-Adressen, die mit ihnen in Verbindung stehen.
  • PUB – Öffentliche Proxies. Dies sind Dienste, die Verbindungsanfragen im Namen eines Nutzers stellen. Die Proxy-Server-Software kann vom Administrator so konfiguriert werden, dass sie auf einem bestimmten Port lauscht. Sie unterscheiden sich von VPNs dadurch, dass die Proxys im Vergleich zu VPNs in der Regel eingeschränkte Funktionen haben.
  • WEB – Web-Proxys. Hierbei handelt es sich um Webdienste, die Webanfragen im Namen eines Benutzers stellen. Sie unterscheiden sich von VPNs oder öffentlichen Proxys dadurch, dass sie einfache webbasierte Proxys sind und nicht auf der Ebene der IP-Adresse und anderer Ports arbeiten.
  • SES – Suchmaschinen-Roboter. Dies sind Dienste, die eine Website crawlen oder scrapen, wie z. B. die Suchmaschinenspider oder -bots.
string
Allowed values: VPN TOR DCH PUB WEB SES
connection_type

Internet Einwahltyp kann sein: “dialup”, “isdn”, “cable”, “dsl”, “fttx”, “wireless” oder null

string | null
Allowed values: dialup isdn cable dsl fttx wireless
is_ok

Was the request handled correctly?

boolean
request_address
Any of:

Fraud check request address

object
@id

JSON-LD ID

string
@type

JSON-LD type

string
@context
One of:
string
status_code

Statuscode der Anfrage

integer | null
iso2
required

Ländercode

string
>= 2 characters <= 2 characters /^[A-Z]{2}$/
city
required

Name der Stadt

string | null
>= 2 characters <= 100 characters
postcode

Postleitzahl

string | null
>= 3 characters <= 20 characters
street_number

Hausnummer

string | null
>= 1 characters <= 30 characters
street_name
required

Straßename

string | null
>= 2 characters <= 255 characters
created_at

Zeitstempel, wann die Entität vom Benutzer zum System hinzugefügt wurde

integer
updated_at

Zeitstempel, wann die Entität geändert wurde

integer
price

Preis

number
hydra:totalItems

Total number of items in the collection

integer
hydra:view

Pagination links for navigating the collection

object
@id
string format: iri-reference
@type
string
hydra:first
string format: iri-reference
hydra:last
string format: iri-reference
hydra:previous
string format: iri-reference
hydra:next
string format: iri-reference
hydra:search

Search and filtering template for the collection

object
@type
string
hydra:template
string
hydra:variableRepresentation
string
hydra:mapping
Array<object>
object
@type
string
variable
string
property
string | null
required
boolean
Example 
{
  "member": [
    {
      "@context": {
        "hydra": "http://www.w3.org/ns/hydra/core#"
      },
      "status_code": 0,
      "service_code": "economy",
      "request_phone": {
        "@context": {
          "hydra": "http://www.w3.org/ns/hydra/core#"
        },
        "status_code": 0,
        "phone": "+14155552671",
        "region": "US"
      },
      "request_email": {
        "@context": {
          "hydra": "http://www.w3.org/ns/hydra/core#"
        },
        "status_code": 0
      },
      "request_ip": {
        "@context": {
          "hydra": "http://www.w3.org/ns/hydra/core#"
        },
        "status_code": 0,
        "iso2": "US",
        "proxy_type": "VPN",
        "connection_type": "dialup"
      },
      "request_address": {
        "@context": {
          "hydra": "http://www.w3.org/ns/hydra/core#"
        },
        "iso2": "US"
      }
    }
  ],
  "hydra:view": {
    "@id": "string",
    "@type": "string",
    "hydra:first": "string",
    "hydra:last": "string",
    "hydra:previous": "string",
    "hydra:next": "string"
  }
}

400

Abschnitt betitelt „400 “

Ungültige Eingabe

401

Abschnitt betitelt „401 “

Kunden-Nr oder API Key sind ungültig oder inaktiv!

403

Abschnitt betitelt „403 “

Account ist noch nicht innerhalb von 24h nach Registrierung aktiviert. Bitte warten oder Support kontaktieren

429

Abschnitt betitelt „429 “

Die IP-Adresse wurde vorübergehend blockiert, da in kurzer Zeit viele Anfragen mit ungültigen Anmeldeinformationen gesendet wurden. Bitte warten Sie und versuchen Sie es später.

Code Samples

 
#!/usr/bin/env bash
curl -X GET https://api.lox24.eu/fraud-checks \
  -H 'X-LOX24-AUTH-TOKEN: 1234567:e3f3a759b6677959b6ebfcxxxxxxxxxx'