POST /v2/registration

This endpoint is used to request a recommendation when a customer or supplier attempts to register for a new account. Ravelin will recommend whether you should allow the user to register. This endpoint is also used to notify Ravelin about the outcome of registration attempts.

timestamp integer

The time at which this data payload was valid. When sending events in realtime, this will usually be 'now'. This is used to merge data that arrives out-of-order.

A unix timestamp preferably as an integer count of milliseconds since 1970-01-01T00:00 UTC (nanoseconds are also accepted).

registration object

The details of the user who is registering. If a customer is registering provide additional details in the customer field. If a supplier is registering provide additional details in the supplier field.

Show definition
customer object

The customer trying to register.

Show definition
supplier object

The supplier trying to register.

Show definition
device object

The device used by the customer to trigger this update.

Show definition
POST /v2/registration HTTP/1.1
Authorization: token ...
Content-Type: application/json

    "timestamp": 1512828988826,
    "registration": {
        "timestamp": 1512828988826,
        "app": {
            "name": "Our App Lite",
            "platform": "web",
            "domain": ""
        "username": "",
        "registrationMechanism": {
            "password": {
                "passwordHashed": "ef92b778bafe771e89245b89ecbc08a44a4e166c06659911881f383d4473e94f",
                "success": false,
                "failureReason": "PASSWORD_TOO_SIMPLE"
        "guestAccount": false,
        "marketingEmailsEnabled": false,
        "success": false
    "customer": {
        "customerId": "abc-123-ZYZ",
        "email": "",
        "emailVerifiedTime": 1512828988826,
        "name": "John Smith",
        "familyName": "Smith",
        "givenName": "John",
        "telephone": "+16045555555",
        "telephoneVerifiedTime": 1512828988826,
        "telephoneCountry": "DOM",
        "tags": {
            "foo": true,
            "bar": false
    "device": {
        "deviceId": "65fc5ac0-2ba3-4a3b-aa5e-f5a77b845260",
        "ipAddress": "",
        "language": "en-US",
        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/69.0.3497.100 Safari/537.36",
        "model": "Pixel XL",
        "os": "android",
        "type": "phone",
        "manufacturer": "google",
        "location": {
            "country": "GBR",
            "postalCode": "E1 1AA",
            "latitude": 51.503252,
            "longitude": -0.127899,
            "addresseeName": "John Smith",
            "street1": "123 fake st.",
            "street2": "floor 4, flat 48",
            "neighbourhood": "Hackney",
            "zone": "1",
            "city": "London",
            "region": "California",
            "poBoxNumber": "1234"


© Ravelin Technology Ltd. All rights reserved