API

Methods

Objects

Match Objects

CustomerData CustomerData information.
CustomerDataList CustomerData container.
MatchRequest MatchRequest object.
MatchRestRequest Request wrapper for match lookup REST methods.
MatchEntityResult MatchEntityResult information.
MatchEntityResultList MatchEntityResult container.
MatchResult MatchResult information.
MatchResultList MatchResult container.
MatchResultRestResponse Response wrapper for match lookup REST methods.

CustomerData

The CustomerData object is used when sending data for the match lookup API methods.

id

Type: String The identifier for each data set.

addresses

Type: AddressList The address list in a data set. Only one address is allowed for one data set.

emailAddresses

Type: EmailList The email address list in a data set. Only one email address is allowed for one data set.

phones

Type: PhoneList The phone list in a data set. Only one phone is allowed for one data set.

JSON Representation


    {
        "id": "c1",
        "addresses": [ { "fullAddress": "level 2, 220 george street, sydney nsw 2000" } ],
        "emailAddresses": [ { "address": "test@mydomain.com" } ],    
        "phones": [ { "fullPhone": "12345678" } ]
    }

With address components:


    {
        "id": "r2",
        "addresses": [ {
            "floorLevelNumber": "2",
            "floorLevelType": "level",
            "streetName": "george",
            "streetNumber": "220",
            "streetType": "street",
            "locality":"sydney",
            "state":"nsw"
        } ], 
        "phones": [ { "fullPhone": "12345678" } ]                 
    }

CustomerDataList

An array or list of CustomerData structures.

JSON Representation


    {
        "id": "c1",
        "addresses": [ { "fullAddress": "level 2, 220 george street, sydney nsw 2000" } ],
        "emailAddresses": [ { "address": "test@mydomain.com" } ],    
        "phones": [ { "fullPhone": "12345678" } ]
    }

With address components:


    {
        "id": "r2",
        "addresses": [ {
            "floorLevelNumber": "2",
            "floorLevelType": "level",
            "streetName": "george",
            "streetNumber": "220",
            "streetType": "street",
            "locality":"sydney",
            "state":"nsw"
        } ], 
        "phones": [ { "fullPhone": "12345678" } ]                 
    }

MatchRequest

A MatchRequest object is used when sending data from the customer match API methods.

from

Type: CustomerDataList The list of CustomerData structures representing the Customer Record (CR) data set. Only one data set is allowed for CR.

to

Type: CustomerDataList The list of CustomerData structures representing the Reference Record (RR) data set. Multiple data sets are allowed for RR.

JSON Representation


    {
        "from": [
            {
                "addresses": [ { "fullAddress": "220 george street, sydney nsw 2000" } ],
                "id": "c1"
            }
        ],
        "to": [
            {
                "addresses": [ { "fullAddress": "220 george street, sydney nsw 2000" } ],
                "id": "r1"
            },
            {
                "addresses": [ { "fullAddress": "level 2, 220 george street, sydney nsw 2000" } ],
                "id": "r2"
            }
        ]
    }

MatchRestRequest

A MatchRestRequest object is used when invoking the match lookup REST service methods.

payload

Type: MatchRequest The MatchRequest object being passed to the REST service method.

featureOptions

Type: FeatureOption An Object containing the values for the feature options available for Match Lookup. Currently is not implemented.

JSON Representation


    {
        "payload": {
            "from": [
                {
                    "addresses": [ { "fullAddress": "220 george street, sydney nsw 2000" } ],			
                    "id": "c1"
                }
            ],
            "to": [
                {
                    "addresses": [ { "fullAddress": "220 george street, sydney nsw 2000" } ],			
                    "id": "r1"
                },
                {
                    "addresses": [ { "fullAddress": "level 2, 220 george street, sydney nsw 2000" } ],			
                    "id": "r2"
                }
            ]
        }
    }

MatchEntityResult

The MatchEntityResult object is used when receiving data for the match lookup API methods.

addressPairIdx

Type: List of Integer The indexes of the matched addresses.

emailAddressPairIdx

Type: List of Integer The indexes of the matched email addresses.

phonePairIdx

Type: List of Integer The indexes of the matched phones.

assignedMatchClass

Type: String The assigned match class.

confidenceLevel

Type: String The match confidence level.

description

Type: String The description of the match class.

matchCategory

Type: String The match category.

JSON Representation


    {
        "addressPairIdx": [ 0, 0 ],
        "emailAddressPairIdx": [],
        "phonePairIdx": [ 0, 0 ],
        "assignedMatchClass": "H1",
        "confidenceLevel": "10",
        "description": "Household Match Class H1",
        "matchCategory": "MATCH_CLASS"
    }

MatchEntityResultList

An array or list of MatchEntityResult structures. Currently will only return one MatchEntityResult in the list.

JSON Representation


    "entityResults": [ 
        {
            "addressPairIdx": [ 0, 0 ],
            "emailAddressPairIdx": [],
            "phonePairIdx": [ 0, 0 ],
            "assignedMatchClass": "H1",
            "confidenceLevel": "10",
            "description": "Household Match Class H1",
            "matchCategory": "MATCH_CLASS"
        }, 
        {
            . . . .
        }
    ]

MatchResult

The MatchResult object is used when receiving data for the match lookup API methods.

fromId

Type: String The identifier for Customer Record (CR) data set.

toId

Type: String The identifier for Reference Record (RR) data set.

entityResults

Type: MatchEntityResultList The MatchEntityResult list for the corresponding fromId and toId.

JSON Representation


    {
        "fromId": "c1",
        "toId": "r1",
        "entityResults": [ {
            "addressPairIdx": [ 0, 0 ],
            "emailAddressPairIdx": [],
            "phonePairIdx": [ 0, 0 ],
            "assignedMatchClass": "H1",
            "confidenceLevel": "10",
            "description": "Household Match Class H1",
            "matchCategory": "MATCH_CLASS"
        } ]
    }

MatchResultList

An array or list of MatchResult structures.

JSON Representation


    {
        "fromId": "c1",
        "toId": "r1",
        "entityResults": [ {
            "addressPairIdx": [ 0, 0 ],
            "emailAddressPairIdx": [],
            "phonePairIdx": [ 0, 0 ],
            "assignedMatchClass": "H1",
            "confidenceLevel": "10",
            "description": "Household Match Class H1",
            "matchCategory": "MATCH_CLASS"
        } ]
    },
    {
        "fromId": "c1",
        "toId": "r2",
        "entityResults": [ {
            "addressPairIdx": [ 0, 0 ],
            "emailAddressPairIdx": [],
            "phonePairIdx": [],
            "assignedMatchClass": "G2",
            "confidenceLevel": "8",
            "description": "Address Match Class G2",
            "matchCategory": "MATCH_CLASS"
        } ]
    }

MatchResultRestResponse

A MatchResultRestResponse object is returned from the match lookup REST service methods.

payload

Type: MatchResultList The list of MatchResult structures being returned from the REST service method.

status

Type: String The status of the request (i.e. 'SUCCESS' or 'ERROR').

messages

Type: String[] Any error messages generated during the REST service method invocation (e.g. '[ "Access is denied" ]')

JSON Representation


    {
        "status": "SUCCESS",
        "messages": [],
        "payload": [
            {
                "fromId": "c1",
                "toId": "r1",
                "entityResults": [ {
                    "addressPairIdx": [ 0, 0 ],
                    "emailAddressPairIdx": [],
                    "phonePairIdx": [ 0, 0 ],
                    "assignedMatchClass": "H1",
                    "confidenceLevel": "10",
                    "description": "Household Match Class H1",
                    "matchCategory": "MATCH_CLASS"
                } ]
            },
            {
                "fromId": "c1",
                "toId": "r2",
                "entityResults": [ {
                    "addressPairIdx": [ 0, 0 ],
                    "emailAddressPairIdx": [],
                    "phonePairIdx": [],
                    "assignedMatchClass": "G2",
                    "confidenceLevel": "8",
                    "description": "Address Match Class G2",
                    "matchCategory": "MATCH_CLASS"
                } ]
            }
        ]
    }