Data Service

Data Service provide customers with direct access to raw data through our suite of APIs. These APIs enable you to retrieve and utilise data for various purposes, giving you the flexibility to develop your own products and services. If OneID does not currently offer a solution that meets your specific needs, you can leverage our APIs to create a bespoke product tailored to your requirements.

Data Sources

OneID® Data Services connect you to following data sources:

• Bank data (Bank Account Verification)
• Credit Bureau data
• Mobile Network Operator (MNO) data

API

Data Service APIs can be found in the Data Service API ReferenceAPI.

Data Service - Identity Verification

POST https://api.myoneid.co.uk/v1/data/verify-identity

The /data/verify-identity endpoint can verify the provided identity information by matching it against credit bureau data. The full identity profile must be supplied in order to get a match. The state parameter is a random id used to identify the request.

Example Request

curl -X POST https://api.oneid.uk/v1/data/verify-identity \

-H "Authorization: bearer <token_from_above>" \

-H "Content-Type: application/json" \

-d '{

  "state": "08310cfe-dd8f-4d34-bbe2-d6b01ac1437d",

  "first_name": "John",

  "surname": "Doe",

  "birthdate": "1990-07-15",

  "address": {

    "sub_building": "Apartment 2B",

    "building_number": "45",

    "building_name": "Sunset Apartments",

    "street": "Elm Street",

    "city": "Springfield",

    "postal_code": "12345",

    "administrative_area": "Springfield County",

    "country_iso2": "US"

  }

}'

Example Response - Success

HTTP/1.1 200 OK

{  

    "state": "08310cfe-dd8f-4d34-bbe2-d6b01ac1437d",

    "name":"Janet Davidson",

    "given_name":"Janet",

    "family_name":"Davidson",

    "birthdate":"1985-06-01",

    "address": {

        "street_address":"3614 Poe Road",

        "locality":"Heworth",

        "region":"York",

        "postal_code":"YO31 1EB",

        "country":"UK"

   } 

}

Example Response - Error

{

  "state": "08310cfe-dd8f-4d34-bbe2-d6b01ac1437d",

  "id": "1234",

  "message": "This is an error"

}

Lookup By Phone Number API Sequence Diagram

This API can be used to verify the age of the primary account holder using mobile network operator data.

API documentation can be found at Data Service API ReferenceAPI under "Identity - Lookup By Phone Number".