📘

POST /supplier/v1/subsamples/{subsampleId}/get-basic

Returns very basic field stats in quasi real time for field monitoring at the subsample and quota level. For pending subsamples or no traffic yet, the method returns quotas with 0.

Caching: 5 minutes

field namedescription
completesNumber of completes achieved on a specific quota
subsampleStatusSubsample status ids; We added below a list with them.
quotaIdQuota number on our data base
inPrescreenernumber of respondents in the prescreening part of the questionnaire
inSurveynumber of respondents that are completing the survey
remainingExclusiveNumber of completes left to achieve from the exclusive.
remainingSharedNumber of completes left to achieve from the exclusive.
subsampleTotalThe total number of completes needed for the quota

subsample Status list

Subsample status_idstatus_nameDescription
1PendingStudy is paused, traffic should be stopped/ no traffic should be sent.
2Pending(do not use)Not Applicable
3LiveReal traffic can be sent, data collection started.
4CompleteField achieved, no more traffic required.
5CanceledSubsample no longer needed on Ipsos end.
6Live for testingStatus is set before the study is pushed to "Live", in order to test the survey by Ipsos/Partners. No real respondent should be sent when a subsample have this status!
983

get-basic returns for these quotas in field

[
  {
    "completes": 0,
    "subsampleStatus": 3,
    "quotaId": 76657,
    "inPrescreener": 0,
    "inSurvey": 0,
    "remainingExclusive": 100,
    "remainingShared": 50,
    "subsampleTotal": 150
  },
  {
    "completes": 0,
    "subsampleStatus": 3,
    "quotaId": 76658,
    "inPrescreener": 0,
    "inSurvey": 0,
    "remainingExclusive": 100,
    "remainingShared": 50,
    "subsampleTotal": 150
  },
  {
    "completes": 0,
    "subsampleStatus": 3,
    "quotaId": 76659,
    "inPrescreener": 0,
    "inSurvey": 0,
    "remainingExclusive": 100,
    "remainingShared": 50,
    "subsampleTotal": 150
  },
  {
    "completes": 0,
    "subsampleStatus": 3,
    "quotaId": 76660,
    "inPrescreener": 0,
    "inSurvey": 0,
    "remainingExclusive": 100,
    "remainingShared": 50,
    "subsampleTotal": 150
  },
  {
    "completes": 0,
    "subsampleStatus": 3,
    "quotaId": 76661,
    "inPrescreener": 0,
    "inSurvey": 0,
    "remainingExclusive": 200,
    "remainingShared": 100,
    "subsampleTotal": 300
  },
  {
    "completes": 0,
    "subsampleStatus": 3,
    "quotaId": 76662,
    "inPrescreener": 0,
    "inSurvey": 0,
    "remainingExclusive": 24,
    "remainingShared": 12,
    "subsampleTotal": 36
  },
  {
    "completes": 0,
    "subsampleStatus": 3,
    "quotaId": 76663,
    "inPrescreener": 0,
    "inSurvey": 0,
    "remainingExclusive": 20,
    "remainingShared": 10,
    "subsampleTotal": 30
  },
  {
    "completes": 0,
    "subsampleStatus": 3,
    "quotaId": 76664,
    "inPrescreener": 0,
    "inSurvey": 0,
    "remainingExclusive": 60,
    "remainingShared": 30,
    "subsampleTotal": 90
  },
  {
    "completes": 0,
    "subsampleStatus": 3,
    "quotaId": 76665,
    "inPrescreener": 0,
    "inSurvey": 0,
    "remainingExclusive": 40,
    "remainingShared": 20,
    "subsampleTotal": 60
  },
  {
    "completes": 0,
    "subsampleStatus": 3,
    "quotaId": 76666,
    "inPrescreener": 0,
    "inSurvey": 0,
    "remainingExclusive": 56,
    "remainingShared": 28,
    "subsampleTotal": 84
  }
]