Connect API Catalog
/
Consumer And Misc
/
API Documentation
/
Consumers

Consumer And Misc (1.0.0)

Introduction

Endpoints to order Consumer Reports. In order to order a Consumer Report, sufficient information to uniquely identify the Consumer (search criteria) must be provided to filter potential results down to one record. When one record has been found, the returned object will be the Consumer Report. Currently only piloting with German Consumers.

Download OpenAPI description
consumerAndMisc.json
consumerAndMisc.yaml
Languages
Servers
Mock server
https://creditsafe-connect-api.redocly.app/_mock/connect-apis-catalog/product-catalog/consumermisc/consumerandmisc/
Sandbox server
https://connect.sandbox.creditsafe.com/v1/
Production server
https://connect.creditsafe.com/v1/

Authentication

Operations

Consumers

Update this description.

Operations

Consumer Report

Request

Consumer Search and Report endpoint. When sufficient information has been provided to filter potential Consumer results down to one record then the Consumer Report will be returned.

Query
countriesstring(CreditsafeGlobalDataCountryCode)required

ISO-2 country code

Enum"AF""AX""AL""DZ""AS""AD""AO""AI""AQ""AG"
Example: countries=DE
languagestring or null= 2 characters
Default "EN"
firstNamestringrequired

Consumer's First Name

lastNamestringrequired

Consumer's Last Name

streetstringrequired

Address part identifier - Street of the Consumer

houseNostringrequired

Address part identifier - House/Building Number of the Consumer

citystringrequired

Address part identifier - City of the Consumer

postCodestringrequired

Address part identifier - Postcode/Zip Code of the Consumer

dateOfBirthstring or null(date-time)
customDatastring or null
Example: customData=de_reason_code::ER
callRefstring or null

This parameter allows users to assign a unique identifier to their API queries. By using a callRef, it facilitates easier tracking and logging within Connect. If you provide a callRef, the Connect team can later retrieve and identify the specific requests associated with that identifier, enabling detailed tracing of interactions.

Default null
curl -i -X GET \
  'https://creditsafe-connect-api.redocly.app/_mock/connect-apis-catalog/product-catalog/consumermisc/consumerandmisc/consumers?city=string&countries=DE&customData=de_reason_code%3A%3AER&dateOfBirth=2019-08-24T14%3A15%3A22Z&firstName=string&houseNo=string&language=EN&lastName=string&postCode=string&street=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Bodyapplication/json
totalSizeinteger(int32)
consumersArray of objects(CreditsafeGlobalDataReportsConsumerConsumerReport)
Response
application/json
{
  "totalSize": 0,
  "consumers": [
    { … }
  ]
}

Consumer Search Criteria

Request

Returns country specific fields that can be used to search for a Consumer.

Query
countriesstringrequired

Comma-separated list of ISO-2 country codes

callRefstring

This parameter allows users to assign a unique identifier to their API queries. By using a callRef, it facilitates easier tracking and logging within Connect. If you provide a callRef, the Connect team can later retrieve and identify the specific requests associated with that identifier, enabling detailed tracing of interactions.

curl -i -X GET \
  'https://creditsafe-connect-api.redocly.app/_mock/connect-apis-catalog/product-catalog/consumermisc/consumerandmisc/consumers/searchcriteria?callRef=string&countries=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Bodyapplication/jsonArray [
countriesArray of strings(CreditsafeGlobalDataCountryCode)
Items Enum"AF""AX""AL""DZ""AS""AD""AO""AI""AQ""AG"
criteriaSetsArray of objects
]
Response
application/json
[
  {
    "countries": [ … ],
    "criteriaSets": [ … ]
  }
]