OneID Data Services

OneID Data Services 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

Authentication

To interact with the Data Services API, you will first need to obtain a token by exchanging your client id and secret. This token will be used to authenticate subsequent requests. In order to receive your credentials, please reach out to our sales team.

Details on how to authenticate can be found in our API ReferenceAPI.

Bank Account Verification

Details about this API can be found in our API ReferenceAPI under "Lookup Identity by Bank Account".

Testing

The following test cases can be used in the sandbox environment.

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"

}

Data Service - Age Verify

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 API ReferenceAPI under "Identity - Lookup By Phone Number".