PATCH
/
v1
/
projects
/
{projectId}
/
screener-responses
/
{screenerResponseId}
/
reject
Mark as rejected
curl --request PATCH \
  --url https://api-staging.respondent.io/v1/projects/{projectId}/screener-responses/{screenerResponseId}/reject \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-api-secret: <x-api-secret>'
{
  "qualified": true,
  "qualifiedPendingIdVerification": true,
  "percentage": 123,
  "status": "PENDING",
  "favorite": true,
  "hidden": true,
  "responses": [
    {
      "questionId": "<string>",
      "questionText": "<string>",
      "order": 123,
      "type": "<string>",
      "questionType": "radio",
      "answers": [
        {
          "id": "<string>",
          "uid": "<string>",
          "text": "<string>",
          "answerValue": 123,
          "goToQuestionUid": "<string>",
          "isOther": true,
          "other": "<string>"
        }
      ],
      "qualify": true
    }
  ],
  "totalTime": 123,
  "isNew": true,
  "inviteSentAt": "2023-11-07T05:31:56Z",
  "scheduledAt": "2023-11-07T05:31:56Z",
  "statusUpdatedAt": "2023-11-07T05:31:56Z",
  "ndaUrl": "<string>",
  "ndaAgree": true,
  "project": {
    "name": "<string>",
    "incentive": 123,
    "id": "<string>",
    "organizationId": "<string>",
    "teamId": "<string>"
  },
  "profile": {
    "id": "<string>",
    "userId": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "picture": "<string>",
    "skills": [
      {
        "id": "<string>",
        "name": "<string>",
        "slug": "<string>",
        "validated": false,
        "type": "skill"
      }
    ]
  },
  "matching": {
    "isGenderMatch": true,
    "isAgeMatch": true,
    "isEthnicityMatch": true,
    "isEducationMatch": true,
    "questionsQualified": true,
    "isLocationMatch": true,
    "isIndustryMatch": true,
    "isJobTitleMatch": true,
    "isHouseholdIncomeMatch": true,
    "isCompanySizeMatch": true,
    "isTopicsMatch": true
  },
  "externalProject": {
    "researcherId": "<string>",
    "bookingUrl": "<string>",
    "meetingCancelLink": "<string>",
    "bookedDate": "2023-11-07T05:31:56Z",
    "timezone": "<string>"
  },
  "invitation": {
    "id": "<string>",
    "remoteCommunicationDetails": "<string>",
    "event": {
      "uid": "<string>"
    },
    "message": null,
    "videoProvider": {
      "loginProviderId": "<string>",
      "providerKey": "zoom",
      "userId": "<string>"
    }
  },
  "actor": "researcher",
  "reason": "time",
  "shortNoticeCancel": true,
  "message": "<string>",
  "rejection": {
    "message": "<string>",
    "rejectedAt": "2023-11-07T05:31:56Z"
  },
  "visibility": {
    "status": "VISIBLE"
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "task": {
    "completedAt": "<string>"
  },
  "id": "<string>",
  "projectId": "<string>",
  "userId": "<string>"
}

Headers

x-api-key
string
required
x-api-secret
string
required

Path Parameters

projectId
string
required
screenerResponseId
string
required

Response

200 - application/json
qualified
boolean
required
percentage
number
required
status
enum<string>
required
Available options:
PENDING,
INVITED,
SCHEDULED,
ATTENDED,
NOSHOW,
INVALIDRESPONSE,
REJECTEDQUALITY,
PAID,
CANCELLED
responses
object[]
required
totalTime
number
required
matching
object
required
visibility
object
required

The visibility status of the screener response. If a screener response is visible, it can be interacted with (invited etc). If a screener response is not visible, it cannot be interacted with. A screener may be hidden for various reasons, and a screener can change from visible to not visible at any time if a participant or screener is found to be untrustworthy. There is a webhook that will notify the client when a screener response changes visibility.

id
string
required
projectId
string
required
userId
string
required
qualifiedPendingIdVerification
boolean
  • This property is set to true (with qualified set to false) if the participant has qualified based on their responses to the screener, but is in the process of verifying their identity.
  • Once the participant has completed ID verification, qualifiedPendingIdVerification will be set to false.
    • If the verification was successful, qualified will be set to true.
    • If the verification failed, qualified will remain set to false unless they were manually qualified through the qualification endpoint (PATCH /projects/{projectId}/screener-responses/{screenerResponseId}/qualify).
favorite
boolean
hidden
boolean
isNew
boolean
inviteSentAt
string<date-time>
scheduledAt
string<date-time>
statusUpdatedAt
string<date-time>
ndaUrl
string
ndaAgree
boolean
project
object
profile
object
externalProject
object
invitation
object
actor
enum<string>
Available options:
researcher,
respondent,
admin
reason
enum<string>
Available options:
time,
final
shortNoticeCancel
boolean
message
string
rejection
object
createdAt
string<date-time>
task
object