Get All Respondents

Get all respondents

curl --request POST \
  --url https://api.redem.io/v2/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
          }
        ]
      }
    }
  ]
}

POST

getAllRespondents

Get all respondents

curl --request POST \
  --url https://api.redem.io/v2/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

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

success

enum<boolean>

A variable indicating whether the operation was successful.

Available options:

true,

false

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.

Show child attributes

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.

Show child attributes

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

Show child attributes

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.

Show child attributes

results.respondentQuality.dataPointsSummary.qualityCheck

enum<string>

Type of quality check performed for the data point

Available options:

OES,

TS,

GQS,

CHS,

BAS

Example:

"OES"

results.respondentQuality.dataPointsSummary.dataPointId

string

A unique identifier of the data point

Example:

"Q1"

results.respondentQuality.dataPointsSummary.score

number

Quality score for the data point, ranging from 0 to 100

Example:

85

results.respondentQuality.dataPointsSummary.category

string

Quality category for the data point, this will be only available if the quality check type is set to OES or BAS

Example:

"VALID_ANSWER"

results.respondentQuality.dataPointsSummary.reason

string

Explanation for the score, this will be only available if the quality check type is set to GQS

Example:

"Straightliner, Partial Straightliner"

Get Respondent Restart Survey

⌘I

How to integrate

API Specifications

Endpoints

Others

Authorizations

Body

Response