Get All Respondents

POST

getAllRespondents

curl --request POST \
  --url https://api.redem.io/getAllRespondents \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '{
  "surveyName": "Global Vacation Insights 2024"
}'

{
  "success": true,
  "message": "Respondents quality retrieved successfully",
  "results": [
    {
      "respondentId": "RESP497770",
      "status": "COMPLETED",
      "respondentQuality": {
        "isExcluded": false,
        "reasonsForExclusion": [
          "Open Ended Score Threshold",
          "Coherence Score Threshold"
        ],
        "redemScore": 85,
        "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
          }
        ],
        "qualityScoreSummary": [
          {
            "qualityCheck": "OES",
            "score": 80
          },
          {
            "qualityCheck": "CHS",
            "score": 75,
            "reason": "The user shows several inconsistencies and contradictions, such as different ..."
          },
          {
            "qualityCheck": "GQS",
            "score": 85
          },
          {
            "qualityCheck": "TS",
            "score": 70
          }
        ]
      }
    },
    {
      "respondentId": "RESP497771",
      "status": "PROCESSING"
    },
    {
      "respondentId": "RESP497772",
      "status": "PROCESSING"
    },
    {
      "respondentId": "RESP497773",
      "status": "COMPLETED",
      "respondentQuality": {
        "isExcluded": false,
        "reasonsForExclusion": [],
        "redemScore": -999,
        "dataPointsSummary": [
          {
            "qualityCheck": "OES",
            "dataPointId": "Q1",
            "score": -999,
            "category": "N/A"
          },
          {
            "qualityCheck": "TS",
            "dataPointId": "durationQ1",
            "score": -999
          },
          {
            "qualityCheck": "GQS",
            "dataPointId": "Q2",
            "score": -999
          },
          {
            "qualityCheck": "OES",
            "dataPointId": "Q3",
            "score": -999,
            "category": "N/A"
          },
          {
            "qualityCheck": "TS",
            "dataPointId": "durationQ3",
            "score": -999
          },
          {
            "qualityCheck": "CHS",
            "dataPointId": "CHS_Question",
            "score": -999,
            "reason": "N/A"
          },
          {
            "qualityCheck": "GQS",
            "dataPointId": "Q4",
            "score": -999
          },
          {
            "qualityCheck": "TS",
            "dataPointId": "totalDuration",
            "score": -999
          }
        ],
        "qualityScoreSummary": [
          {
            "qualityCheck": "OES",
            "score": -999
          },
          {
            "qualityCheck": "CHS",
            "score": -999,
            "reason": "N/A"
          },
          {
            "qualityCheck": "GQS",
            "score": -999
          },
          {
            "qualityCheck": "TS",
            "score": -999
          }
        ]
      }
    }
  ]
}

Authorizations

api-key

string

header

required

Body

application/json

Request body for getting all respondents

surveyName

string

required

The name of the survey.

Response

200

application/json

When a request is successfully processed, the API responds with a `200 OK` status code and the expected data.

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

The unique identifier for a respondent, making it easy to distinguish them from others in the survey.

Example:

"RESP497770"

results.status

enum<string>

A variable that indicates the current state of the respondent.

💡Important: Even if a respondent fails evaluation, the response status will still be COMPLETED.

⭕ 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.

Available options:

COMPLETED,

QUEUED

results.respondentQuality

object

This variable represents respondent data that has been evaluated according to the quality checks specified in the /addRespondent request.

⭕ Note: this variable will only available if the respondent status is COMPLETED.

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

Get Respondent Stop Survey

curl --request POST \
  --url https://api.redem.io/getAllRespondents \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '{
  "surveyName": "Global Vacation Insights 2024"
}'

{
  "success": true,
  "message": "Respondents quality retrieved successfully",
  "results": [
    {
      "respondentId": "RESP497770",
      "status": "COMPLETED",
      "respondentQuality": {
        "isExcluded": false,
        "reasonsForExclusion": [
          "Open Ended Score Threshold",
          "Coherence Score Threshold"
        ],
        "redemScore": 85,
        "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
          }
        ],
        "qualityScoreSummary": [
          {
            "qualityCheck": "OES",
            "score": 80
          },
          {
            "qualityCheck": "CHS",
            "score": 75,
            "reason": "The user shows several inconsistencies and contradictions, such as different ..."
          },
          {
            "qualityCheck": "GQS",
            "score": 85
          },
          {
            "qualityCheck": "TS",
            "score": 70
          }
        ]
      }
    },
    {
      "respondentId": "RESP497771",
      "status": "PROCESSING"
    },
    {
      "respondentId": "RESP497772",
      "status": "PROCESSING"
    },
    {
      "respondentId": "RESP497773",
      "status": "COMPLETED",
      "respondentQuality": {
        "isExcluded": false,
        "reasonsForExclusion": [],
        "redemScore": -999,
        "dataPointsSummary": [
          {
            "qualityCheck": "OES",
            "dataPointId": "Q1",
            "score": -999,
            "category": "N/A"
          },
          {
            "qualityCheck": "TS",
            "dataPointId": "durationQ1",
            "score": -999
          },
          {
            "qualityCheck": "GQS",
            "dataPointId": "Q2",
            "score": -999
          },
          {
            "qualityCheck": "OES",
            "dataPointId": "Q3",
            "score": -999,
            "category": "N/A"
          },
          {
            "qualityCheck": "TS",
            "dataPointId": "durationQ3",
            "score": -999
          },
          {
            "qualityCheck": "CHS",
            "dataPointId": "CHS_Question",
            "score": -999,
            "reason": "N/A"
          },
          {
            "qualityCheck": "GQS",
            "dataPointId": "Q4",
            "score": -999
          },
          {
            "qualityCheck": "TS",
            "dataPointId": "totalDuration",
            "score": -999
          }
        ],
        "qualityScoreSummary": [
          {
            "qualityCheck": "OES",
            "score": -999
          },
          {
            "qualityCheck": "CHS",
            "score": -999,
            "reason": "N/A"
          },
          {
            "qualityCheck": "GQS",
            "score": -999
          },
          {
            "qualityCheck": "TS",
            "score": -999
          }
        ]
      }
    }
  ]
}

How to integrate

API Specifications

Endpoints

Others

Authorizations

Body

Response