Add Respondent

POST

addRespondent

curl --request POST \
  --url https://api.redem.io/addRespondent \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '{
  "respondentId": "RESP497770",
  "surveyName": "Global Vacation Insights 2024",
  "dataPoints": [
    {
      "qualityCheck": "OES",
      "dataPointId": "Q1",
      "question": "Where did you spend your last vacation?",
      "answer": "We were at Lake Garda in Italy",
      "keywords": [
        "Beach",
        "Mountains",
        "Lake",
        "Museums",
        "Europe",
        "Asia",
        "Destination"
      ],
      "activateDuplicateDetection": true,
      "allowedLanguages": [
        "en",
        "de",
        "it"
      ]
    },
    {
      "qualityCheck": "TS",
      "dataPointId": "durationQ1",
      "duration": 42670
    },
    {
      "qualityCheck": "GQS",
      "dataPointId": "Q2",
      "gridAnswersPattern": [
        7,
        8,
        9,
        1,
        3,
        5,
        2,
        5,
        9,
        6
      ]
    },
    {
      "qualityCheck": "OES",
      "dataPointId": "Q3",
      "question": "What was the most memorable part of your last vacation?",
      "answer": "Italian cuisine, especially pizza and fine wine.",
      "keywords": [
        "Cuisine",
        "Food",
        "Art",
        "Adventure",
        "History",
        "Landscape",
        "Culture"
      ],
      "activateDuplicateDetection": true,
      "allowedLanguages": [
        "en",
        "de",
        "it"
      ]
    },
    {
      "qualityCheck": "TS",
      "dataPointId": "durationQ3",
      "duration": 69720
    },
    {
      "qualityCheck": "CHS",
      "dataPointId": "CHS_Question",
      "interviewData": [
        {
          "question": "What mode of transport did you use?",
          "answer": "Car"
        },
        {
          "question": "How many days did you stay?",
          "answer": 5
        },
        {
          "question": "Did you travel with family?",
          "answer": "yes"
        },
        {
          "question": "What was your approximate total budget for the trip (in EUR)?",
          "answer": 1500
        },
        {
          "question": "What type of accommodation did you stay in?",
          "answer": "Hotel"
        }
      ]
    },
    {
      "qualityCheck": "GQS",
      "dataPointId": "Q4",
      "gridAnswersPattern": [
        2,
        1,
        4,
        3,
        5,
        2,
        3,
        1,
        1,
        1
      ]
    },
    {
      "qualityCheck": "TS",
      "dataPointId": "totalDuration",
      "duration": 256843
    },
    {
      "qualityCheck": "BAS",
      "dataPointId": "interactionsQ1",
      "interactionData": [
        {
          "interactionType": "KEYSTROKE",
          "value": "W",
          "timestamp": "2024-12-01T06:22:59.809Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We",
          "timestamp": "2024-12-01T06:22:59.833Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We ",
          "timestamp": "2024-12-01T06:22:59.909Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We w",
          "timestamp": "2024-12-01T06:22:59.962Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We we",
          "timestamp": "2024-12-01T06:23:00.024Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We were",
          "timestamp": "2024-12-01T06:23:00.086Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We were ",
          "timestamp": "2024-12-01T06:23:00.148Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We were a",
          "timestamp": "2024-12-01T06:23:00.210Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We were at",
          "timestamp": "2024-12-01T06:23:00.272Z"
        }
      ]
    }
  ],
  "activateCleaning": true,
  "cleaningSettings": {
    "redemScore": 60,
    "OES": {
      "activate": true,
      "score": 40,
      "minDataPoints": 2,
      "categories": {
        "GENERIC_ANSWER": {
          "activate": false,
          "minDataPoints": 2
        },
        "NO_INFORMATION": {
          "activate": false,
          "minDataPoints": 2
        },
        "BAD_LANGUAGE": {
          "activate": true,
          "minDataPoints": 2
        },
        "NONSENSE": {
          "activate": true,
          "minDataPoints": 2
        },
        "DUPLICATE_ANSWER": {
          "activate": false,
          "minDataPoints": 1
        },
        "DUPLICATE_RESPONDENT": {
          "activate": false,
          "minDataPoints": 1
        },
        "WRONG_TOPIC": {
          "activate": true,
          "minDataPoints": 2
        },
        "WRONG_LANGUAGE": {
          "activate": true,
          "minDataPoints": 2
        },
        "AI_GENERATED_ANSWER": {
          "activate": true,
          "minDataPoints": 2
        }
      }
    },
    "CHS": {
      "activate": true,
      "score": 20
    },
    "GQS": {
      "activate": true,
      "score": 10,
      "minDataPoints": 2
    },
    "TS": {
      "activate": true,
      "score": 20
    },
    "BAS": {
      "activate": true,
      "score": 10,
      "minDataPoints": 2,
      "categories": {
        "UNNATURAL_TYPING": {
          "activate": true,
          "minDataPoints": 2
        },
        "COPY_AND_PASTE": {
          "activate": true,
          "minDataPoints": 2
        }
      }
    }
  },
  "synchronousResponse": true
}'

{
  "success": true,
  "message": "Respondent Evaluated successfully",
  "results": {
    "respondentId": "RESP497770",
    "status": "COMPLETED",
    "respondentQuality": {
      "isExcluded": true,
      "reasonsForExclusion": [
        "Open Ended Score Threshold",
        "Coherence Score Threshold"
      ],
      "redemScore": 85,
      "qualityScoreSummary": [
        {
          "qualityCheck": "OES",
          "score": 80
        },
        {
          "qualityCheck": "CHS",
          "score": 75,
          "reason": "The user shows several inconsistencies and contradictions, such as different ...",
          "incoherentQuestions": [
            "Q1",
            "Q2"
          ]
        },
        {
          "qualityCheck": "GQS",
          "score": 85
        },
        {
          "qualityCheck": "TS",
          "score": 70
        },
        {
          "qualityCheck": "BAS",
          "score": 75
        }
      ],
      "dataPointsSummary": [
        {
          "qualityCheck": "OES",
          "dataPointId": "Q1",
          "score": 85,
          "category": "VALID_ANSWER"
        },
        {
          "qualityCheck": "TS",
          "dataPointId": "durationQ1",
          "score": 95
        },
        {
          "qualityCheck": "GQS",
          "dataPointId": "Q2",
          "score": 90
        },
        {
          "qualityCheck": "OES",
          "dataPointId": "Q3",
          "score": 75,
          "category": "VALID_ANSWER"
        },
        {
          "qualityCheck": "TS",
          "dataPointId": "durationQ3",
          "score": 50
        },
        {
          "qualityCheck": "CHS",
          "dataPointId": "CHS_Question",
          "score": 75,
          "reason": "The user shows several inconsistencies and contradictions, such as different ..."
        },
        {
          "qualityCheck": "GQS",
          "dataPointId": "Q4",
          "score": 80
        },
        {
          "qualityCheck": "TS",
          "dataPointId": "totalDuration",
          "score": 65
        },
        {
          "qualityCheck": "BAS",
          "dataPointId": "interactionsQ1",
          "score": 75,
          "category": "NATURAL_TYPING"
        }
      ]
    }
  }
}

Authorizations

api-key

string

header

required

Body

application/json

Request body for adding a new respondent

respondentId

string

required

The unique identifier for a respondent, making it easy to distinguish them from others in the survey. The respondent ID can be freely chosen for flexibility.

💡 Important: The system utilizes this ID, combined with the survey name, to uniquely identify the respondent within a survey. This allows the same respondent ID to participate in multiple surveys without conflicts.

If the combination of survey name and respondent ID already exists, an error will be displayed.

🔦 Tip: You can use the same respondent ID as in the survey tool to easily identify the respondent later.

Example:

"RESP497770"

surveyName

string

required

The name of the survery, which helps identify different surveys. The survey name can be assigned freely.

💡Important: If the survey name already exists, the system will add the respondent under the appropriate survey. If the survey name is new, a new survey will be created, and the respondent will be added to the new survey.

⭕ Note: Each survey identifier must be unique for a given user.

🔦 Tip: you can simply make survey name unique by adding a timestamp. As Example: Global Vacation Insights - 1709040600

dataPoints

object[]

required

An array of data points used for quality checks on each respondent. For the Coherence Score (CHS), only a single data point is allowed, which must contain the entire interview.

🧪 Validations:

A maximum of 10 OES data points are allowed per respondent.
A maximum of 100 TS data points are allowed per respondent.
A maximum of 20 GQS data points are allowed per respondent.
A maximum of 1 with 1000 question/answer pairs CHS data point is allowed per respondent.

Exceeding these limits will trigger validation errors. Ensure that the number of data points per respondent remains within the allowed limits.

An array of data points used to perform quality checks on each respondent.

dataPoints.qualityCheck

enum<string>

required

A variable that specifies the type of quality check applied to the data point, determining how it will be assessed and evaluated.

Available options:

OES

dataPoints.dataPointId

string

required

A unique identifier assigned to each data point, allowing users to pick a customized name. This name will be used to identify and reference the data point later within the system.

Example:

"Q1"

dataPoints.question

string

required

Contains the title or text of the open-ended question, which is used directly to evaluate respondent quality.

This variable is required only when the quality check type is set to OES. For all other quality check types, it will be ignored, even if provided.

Example:

"Where did you spend your last vacation?"

dataPoints.answer

string

required

A variable that holds the respondent's answer to an open-ended question, which is the main part we use for evaluation.

This variable is required only when the quality check type is set to OES. For all other quality check types, it will be ignored, even if provided.

Example:

"We were at Lake Garda in Italy"

dataPoints.keywords

string[]

Keywords are used to perform wrong topic checks and help evaluate whether responses are relevant to the topic.

By default, the wrong topic check is disabled. However, if keywords are provided, the system will automatically enable the wrong topic check, and respondents will be evaluated to ensure their answers align with the context defined by the provided keywords and title.

For more details on how this works, refer to the Wrong Topic Check section.

🧪 Validations:

A maximum of 10 keywords are allowed for each question.

Example:

["Beach", "Mountains", "Lake"]

dataPoints.activateDuplicateDetection

boolean

default:true

A variable that indicates whether duplicate checks are performed on the respondent's answers.

This checks if an answer is identical to another respondent's answer or if a respondent provided the same answer to multiple questions.

By default, duplicate checks are active, but you can deactivate them by setting this variable to false.

For more details on how this works, refer to the Duplicate Check section.

Example:

true

dataPoints.allowedLanguages

string[]

Specifies the list of languages allowed for responses. Answers provided in languages not on this list will be marked as wrong language. The specified languages are respondent-based.

If no languages are specified, the wrong language check will not be performed.

🔦 Tip: To ensure accurate language detection, set the expected language to the one the respondent used to complete the questionnaire.

For more details on how this works, refer to the Wrong Language Check section.

🧪 Validations:

Allowed languages should be represented using two-letter ISO 639-1 language codes.

Example:

["en", "de", "it"]

activateCleaning

boolean

default:false

Indicates whether cleaning should be applied to the respondent.

💡Important: To remove bad respondents automatically, ensure this variable is set to true.

When cleaning is enabled, the response will include the variable isExcluded, which indicates whether the respondent has been excluded based on the applied criteria.

Example:

true

cleaningSettings

object

Cleaning settings define the rules for determining whether a respondent should be excluded and marked as low quality. If a respondent’s scores fall below the threshold, they will be excluded and flagged as low quality.

💡Important: If no custom cleaning settings are defined and cleaning is enabled, the system will apply ReDem’s recommended cleaning settings. You can view the recommended settings here: ReDem Recommended Cleaning Settings

For more details on how cleaning works, refer to the Data Cleaning section.

cleaningSettings.redemScore

number

Minimum acceptable ReDem score (0-100)

Example:

60

cleaningSettings.OES

object

cleaningSettings.OES.activate

boolean

Indicates whether OES should be applied as a cleaning parameter.

Example:

true

cleaningSettings.OES.score

number

Minimum score threshold for OES checks

Example:

40

cleaningSettings.OES.minDataPoints

number

Minimum number of data points required

Example:

2

cleaningSettings.OES.categories

object

cleaningSettings.CHS

object

cleaningSettings.GQS

object

cleaningSettings.TS

object

cleaningSettings.BAS

object

synchronousResponse

boolean

default:true

Indicates whether the response should be processed synchronously.

Set to true if you need an immediate response.
Set to false if you don’t need to wait; you can later check the respondent’s status using the Get Respondent Status endpoint.

Example:

true

Response

200

application/json

When a request is successfully processed, the API returns a 200 OK status code along with the expected data. The structure of the response depends on the synchronousResponse parameter provided in the request body, which determines whether the response is synchronous (results of the respondent evaluation are returned immediately) or asynchronous (a respondent is created and the results of the respondent evaluation are available later through a separate endpoint).

Synchronous Response

This response mode is triggered when synchronousResponse is set to true.

In this mode, the system generates a detailed response containing all quality parameters of the respondent. The request will wait (await) until the full response is ready before proceeding.

success

boolean

A variable indicating whether the operation was successful.

message

string

A variable that human-readable message providing additional context or confirmation of the requested action.

results

object

This variable includes all quality parameters associated with a respondent.

results.respondentId

string

A variable that indicates the respondent.

results.status

enum<string>

A variable that represents the current state of the respondent evaluation. For synchronous responses, this value will always be COMPLETED.

Available options:

COMPLETED

results.respondentQuality

object

This variable includes all quality parameters associated with a respondent.

💡Important: Even if a respondent fails evaluation, the response will still be returned with results with an error code of -999 instead of valid scores.

⭕ Note: The value -999 is a predefined code returned by ReDem whenever a respondent cannot be evaluated. This applies to all quality scores, including ReDem Score (R-Score), OES, GQS, CHS, TS, and BAS.

results.respondentQuality.isExcluded

boolean

Indicates whether a respondent is excluded based on the cleaning settings specified in the request. If cleaning is not activated, the respondent is always included by default.

Example:

false

results.respondentQuality.reasonsForExclusion

string[]

Reasons for exclusion will only be available if the respondent is excluded based on the cleaning settings specified in the request. If the respondent is not excluded, the array will be empty.

results.respondentQuality.redemScore

number

A weighted average score (0–100) calculated based on the applied quality scores..

For more information refer to the ReDem Score section.

Example:

85

results.respondentQuality.qualityScoreSummary

object[]

An object containing detailed results for each quality score applied

Aggregated results for a quality score type

results.respondentQuality.qualityScoreSummary.qualityCheck

enum<string>

The specific type of quality check applied to a respondent.

Available options:

OES,

TS,

GQS,

CHS,

BAS

Example:

"OES"

results.respondentQuality.qualityScoreSummary.score

number

A numerical score from 0 to 100 that represents the overall result of a specific quality check. It is calculated based on the combined evaluation of all data point scores of the same quality type.

Example:

78

results.respondentQuality.qualityScoreSummary.reason

string

The reason behind the score — available only when the quality score type is set to CHS.

Example:

"The user shows several inconsistencies and contradictions, such as different ..."

results.respondentQuality.qualityScoreSummary.incoherentQuestions

string[]

List of incoherent questions identified during the CHS quality check. This will be only available if the quality score type is set to CHS

⭕ Note: The questions are named in numerical order, reflecting the sequence in which they were presented to the respondent.

Example:

["Q1", "Q2"]

results.respondentQuality.dataPointsSummary

object[]

Detailed results of quality checks performed at the individual data point level.

Quality check results for a single datapoint

Synchronous Response

This response mode is triggered when synchronousResponse is set to true.

In this mode, the system generates a detailed response containing all quality parameters of the respondent. The request will wait (await) until the full response is ready before proceeding.

success

boolean

A variable indicating whether the operation was successful.

message

string

A variable that human-readable message providing additional context or confirmation of the requested action.

results

object

This variable includes all quality parameters associated with a respondent.

results.respondentId

string

A variable that indicates the respondent.

results.status

enum<string>

A variable that represents the current state of the respondent evaluation. For synchronous responses, this value will always be COMPLETED.

Available options:

COMPLETED

results.respondentQuality

object

This variable includes all quality parameters associated with a respondent.

💡Important: Even if a respondent fails evaluation, the response will still be returned with results with an error code of -999 instead of valid scores.

results.respondentQuality.isExcluded

boolean

Indicates whether a respondent is excluded based on the cleaning settings specified in the request. If cleaning is not activated, the respondent is always included by default.

Example:

false

results.respondentQuality.reasonsForExclusion

string[]

Reasons for exclusion will only be available if the respondent is excluded based on the cleaning settings specified in the request. If the respondent is not excluded, the array will be empty.

results.respondentQuality.redemScore

number

A weighted average score (0–100) calculated based on the applied quality scores..

For more information refer to the ReDem Score section.

Example:

85

results.respondentQuality.qualityScoreSummary

object[]

An object containing detailed results for each quality score applied

Aggregated results for a quality score type

results.respondentQuality.qualityScoreSummary.qualityCheck

enum<string>

The specific type of quality check applied to a respondent.

Available options:

OES,

TS,

GQS,

CHS,

BAS

Example:

"OES"

results.respondentQuality.qualityScoreSummary.score

number

Example:

78

results.respondentQuality.qualityScoreSummary.reason

string

The reason behind the score — available only when the quality score type is set to CHS.

Example:

"The user shows several inconsistencies and contradictions, such as different ..."

results.respondentQuality.qualityScoreSummary.incoherentQuestions

string[]

List of incoherent questions identified during the CHS quality check. This will be only available if the quality score type is set to CHS

⭕ Note: The questions are named in numerical order, reflecting the sequence in which they were presented to the respondent.

Example:

["Q1", "Q2"]

results.respondentQuality.dataPointsSummary

object[]

Detailed results of quality checks performed at the individual data point level.

Quality check results for a single datapoint

Asynchronous Response

This response mode is triggered when synchronousResponse is set to false.

In this case, the system generates a detailed response and processes it asynchronously, meaning the request will not wait (await) for the evaluation to complete. Instead, the evaluation is performed in the background, and the status of the respondent can be retrieved later using the Get Respondent Status endpoint.

success

boolean

A variable indicating whether the operation was successful.

message

string

A variable that human-readable message providing additional context or confirmation of the requested action.

results

object

This variable includes all quality parameters associated with a respondent.

Rate Limits Get Respondent

curl --request POST \
  --url https://api.redem.io/addRespondent \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '{
  "respondentId": "RESP497770",
  "surveyName": "Global Vacation Insights 2024",
  "dataPoints": [
    {
      "qualityCheck": "OES",
      "dataPointId": "Q1",
      "question": "Where did you spend your last vacation?",
      "answer": "We were at Lake Garda in Italy",
      "keywords": [
        "Beach",
        "Mountains",
        "Lake",
        "Museums",
        "Europe",
        "Asia",
        "Destination"
      ],
      "activateDuplicateDetection": true,
      "allowedLanguages": [
        "en",
        "de",
        "it"
      ]
    },
    {
      "qualityCheck": "TS",
      "dataPointId": "durationQ1",
      "duration": 42670
    },
    {
      "qualityCheck": "GQS",
      "dataPointId": "Q2",
      "gridAnswersPattern": [
        7,
        8,
        9,
        1,
        3,
        5,
        2,
        5,
        9,
        6
      ]
    },
    {
      "qualityCheck": "OES",
      "dataPointId": "Q3",
      "question": "What was the most memorable part of your last vacation?",
      "answer": "Italian cuisine, especially pizza and fine wine.",
      "keywords": [
        "Cuisine",
        "Food",
        "Art",
        "Adventure",
        "History",
        "Landscape",
        "Culture"
      ],
      "activateDuplicateDetection": true,
      "allowedLanguages": [
        "en",
        "de",
        "it"
      ]
    },
    {
      "qualityCheck": "TS",
      "dataPointId": "durationQ3",
      "duration": 69720
    },
    {
      "qualityCheck": "CHS",
      "dataPointId": "CHS_Question",
      "interviewData": [
        {
          "question": "What mode of transport did you use?",
          "answer": "Car"
        },
        {
          "question": "How many days did you stay?",
          "answer": 5
        },
        {
          "question": "Did you travel with family?",
          "answer": "yes"
        },
        {
          "question": "What was your approximate total budget for the trip (in EUR)?",
          "answer": 1500
        },
        {
          "question": "What type of accommodation did you stay in?",
          "answer": "Hotel"
        }
      ]
    },
    {
      "qualityCheck": "GQS",
      "dataPointId": "Q4",
      "gridAnswersPattern": [
        2,
        1,
        4,
        3,
        5,
        2,
        3,
        1,
        1,
        1
      ]
    },
    {
      "qualityCheck": "TS",
      "dataPointId": "totalDuration",
      "duration": 256843
    },
    {
      "qualityCheck": "BAS",
      "dataPointId": "interactionsQ1",
      "interactionData": [
        {
          "interactionType": "KEYSTROKE",
          "value": "W",
          "timestamp": "2024-12-01T06:22:59.809Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We",
          "timestamp": "2024-12-01T06:22:59.833Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We ",
          "timestamp": "2024-12-01T06:22:59.909Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We w",
          "timestamp": "2024-12-01T06:22:59.962Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We we",
          "timestamp": "2024-12-01T06:23:00.024Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We were",
          "timestamp": "2024-12-01T06:23:00.086Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We were ",
          "timestamp": "2024-12-01T06:23:00.148Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We were a",
          "timestamp": "2024-12-01T06:23:00.210Z"
        },
        {
          "interactionType": "KEYSTROKE",
          "value": "We were at",
          "timestamp": "2024-12-01T06:23:00.272Z"
        }
      ]
    }
  ],
  "activateCleaning": true,
  "cleaningSettings": {
    "redemScore": 60,
    "OES": {
      "activate": true,
      "score": 40,
      "minDataPoints": 2,
      "categories": {
        "GENERIC_ANSWER": {
          "activate": false,
          "minDataPoints": 2
        },
        "NO_INFORMATION": {
          "activate": false,
          "minDataPoints": 2
        },
        "BAD_LANGUAGE": {
          "activate": true,
          "minDataPoints": 2
        },
        "NONSENSE": {
          "activate": true,
          "minDataPoints": 2
        },
        "DUPLICATE_ANSWER": {
          "activate": false,
          "minDataPoints": 1
        },
        "DUPLICATE_RESPONDENT": {
          "activate": false,
          "minDataPoints": 1
        },
        "WRONG_TOPIC": {
          "activate": true,
          "minDataPoints": 2
        },
        "WRONG_LANGUAGE": {
          "activate": true,
          "minDataPoints": 2
        },
        "AI_GENERATED_ANSWER": {
          "activate": true,
          "minDataPoints": 2
        }
      }
    },
    "CHS": {
      "activate": true,
      "score": 20
    },
    "GQS": {
      "activate": true,
      "score": 10,
      "minDataPoints": 2
    },
    "TS": {
      "activate": true,
      "score": 20
    },
    "BAS": {
      "activate": true,
      "score": 10,
      "minDataPoints": 2,
      "categories": {
        "UNNATURAL_TYPING": {
          "activate": true,
          "minDataPoints": 2
        },
        "COPY_AND_PASTE": {
          "activate": true,
          "minDataPoints": 2
        }
      }
    }
  },
  "synchronousResponse": true
}'

{
  "success": true,
  "message": "Respondent Evaluated successfully",
  "results": {
    "respondentId": "RESP497770",
    "status": "COMPLETED",
    "respondentQuality": {
      "isExcluded": true,
      "reasonsForExclusion": [
        "Open Ended Score Threshold",
        "Coherence Score Threshold"
      ],
      "redemScore": 85,
      "qualityScoreSummary": [
        {
          "qualityCheck": "OES",
          "score": 80
        },
        {
          "qualityCheck": "CHS",
          "score": 75,
          "reason": "The user shows several inconsistencies and contradictions, such as different ...",
          "incoherentQuestions": [
            "Q1",
            "Q2"
          ]
        },
        {
          "qualityCheck": "GQS",
          "score": 85
        },
        {
          "qualityCheck": "TS",
          "score": 70
        },
        {
          "qualityCheck": "BAS",
          "score": 75
        }
      ],
      "dataPointsSummary": [
        {
          "qualityCheck": "OES",
          "dataPointId": "Q1",
          "score": 85,
          "category": "VALID_ANSWER"
        },
        {
          "qualityCheck": "TS",
          "dataPointId": "durationQ1",
          "score": 95
        },
        {
          "qualityCheck": "GQS",
          "dataPointId": "Q2",
          "score": 90
        },
        {
          "qualityCheck": "OES",
          "dataPointId": "Q3",
          "score": 75,
          "category": "VALID_ANSWER"
        },
        {
          "qualityCheck": "TS",
          "dataPointId": "durationQ3",
          "score": 50
        },
        {
          "qualityCheck": "CHS",
          "dataPointId": "CHS_Question",
          "score": 75,
          "reason": "The user shows several inconsistencies and contradictions, such as different ..."
        },
        {
          "qualityCheck": "GQS",
          "dataPointId": "Q4",
          "score": 80
        },
        {
          "qualityCheck": "TS",
          "dataPointId": "totalDuration",
          "score": 65
        },
        {
          "qualityCheck": "BAS",
          "dataPointId": "interactionsQ1",
          "score": 75,
          "category": "NATURAL_TYPING"
        }
      ]
    }
  }
}

How to integrate

API Specifications

Endpoints

Others

Authorizations

Body

Response