The Consumer Search Suite provides a set of endpoints to:
- Authenticate
- Search Criteria
- Customer Data Requirements
- Consumer Search
Before using any of the endpoints, you must authenticate. This ensures you have the necessary permissions to access the data.
POST /authenticateThis endpoint returns all the parameters you (The logged in user) will need to use in the consumer endpoint to narrow the search to one unique result.
This endpoint uses the countries to search for the parameters available.
GET /consumers/searchcriteria?countries=deThe response object will provide a list of query parameters that will need to be submitted in the Consumer request. It will also define if a specific proeprty is required.
{
"correlationId":"0a24e698-2304-4cad-909a-b089db51e940",
"countries":[
"DE"
],
"criteriaSets":[
{
"firstName":{
"required":true
},
"lastName":{
"required":true
},
"dateOfBirth":{
"required":false
},
"address":{
"street":{
"required":true,
"minLength":2
},
"city":{
"required":true,
"minLength":2
},
"postCode":{
"required":true,
"minLength":5,
"maxLength":5
},
"houseNo":{
"required":true
}
},
"customData":{
"required":true
}
}
],
"customData":[
{
"key":"de_reason_code",
"optional":false,
"allowedValues":[
"BD"
],
"allowMultiple":false
}
]
}
The customData parameter in the consumer report endpoint is required for certain countries. If the Consumer Search Criteria endpoint indicates that customData is required, use this endpoint to retrieve the necessary values.
GET /reportcustomdata/deThe consumer report requires a single unique result to generate the report. Ensure that all required parameters are provided to narrow the search to one result.
get /consumers