Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Get Surveys - GET /surveys - http://api.spectrumsurveys.com/suppliers/v2/surveys

...

Call this API to view surveys that your Supplier account has an allocation for.  You are expected to Register Intent & send sample to these surveys.  

You can use this method to check the status of existing surveys you are delivering on, including current LOI, IR, & CPI.


HEADER Parameters


Parameter

Type

Required

Description

access-token

string

Yes

Token used to identify the authenticity of the user.

...

Sample API Response

Code Block
{
  "apiStatus": "success",
  "msg": "survey_id": 825,
	  "cpi": 6Surveys fetched successfully ",
  "version": "2.0",
  "surveys": [
    {
      "cpi": 10.3,
      "survey_grouping": [],
      "supplier_completes": {
        "needed": 24,
        "achieved": 0,
        "remaining": 24
      },
      "survey_performance": {
        "overall": {
          "ir": 8,
          "loi": 32
        },
        "last_block": {
          "ir": 8,
          "loi": 32
        }
      },
      "survey_statusid": 1854,
      "last_complete_date": 22null,
      "survey_name": "AutomotiveMedia and Entertainment Survey #825#1854",
      "surveyLocalization": "en_US",
	      "categorysurvey_status": "Automotive"22,
      "categorybuyer_codeid": 2112,
      "field_end_date": 1487886077000,
      "crtd_on": 1487281277070,
      "last_complete_date": 1487891732857mod_on": 1488314397116,
      "category": "Media and Entertainment",
      "category_code": 224
    },
    {
      "cpi": 16.5,
      "survey_grouping": [],
      "supplier_completes": {
        "needed": 25712,
        "achieved": 01,
        "remaining": 25711
      },
      "survey_performance": {
		
        "overall": {
			          "ir": 804,
        	  "loi": 6,
	 16
        	},
		
        "last_block": {
			
          "ir": 804,
        	  "loi": 6,
	16
        	}
   	   },
      "survey_groupingid": 1983,
   {   "last_complete_date": 1487891732857,
      "survey_idsname": ["Media and Entertainment Survey #1983",
      1373
"surveyLocalization": "en_US",
       ],
"survey_status": 22,
       "exclusionbuyer_periodid": 902,
      }"field_end_date": 1488908564000,
      "crtd_on":124411231313 1487871678958,
      "mod_on": 1488303824981,
      ":11321334733category": "Media and Entertainment",
      "category_code": 224
    }
 ]
}