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: StringThe 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": "[e-mail]" } ],    
        "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": "[e-mail]" } ],    
        "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 IntegerThe indexes of the matched addresses.

emailAddressPairIdx

Type: List of IntegerThe indexes of the matched email addresses.

phonePairIdx

Type: List of IntegerThe indexes of the matched phones.

assignedMatchClass

Type: StringThe assigned match class.

confidenceLevel

Type: StringThe match confidence level.

description

Type: StringThe description of the match class.

matchCategory

Type: StringThe 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: StringThe identifier for Customer Record (CR) data set.

toId

Type: StringThe 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: StringThe 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"
                } ]
            }
        ]
    }