Our updated BUY API documentation is available here.
We hope you enjoy the new experience! Reach out to us with your feedback or questions on supportbuyapi@purespectrum.com
Happy programming! 🎉

This is an example of a scenario where overlapping income ranges are not allowed

Request

POST $apihost/$basepath/surveys

($apihost is the environment against which you are testing, and $basepath is the base path with the api version. All Buy API calls will require access-token parameter in the header)

Parameters:

Body:

  {
  "survey_title": "Sample Survey for Age Income Gender bapit-2",
  "survey_category_code": 231,
  "survey_localization": "en_US",
  "completes_required": 1000,
  "expected_ir": 60,
  "expected_loi": 60,
  "offer_price": 4.5,
  "live_url": "https://my.survey.com?survey_id=1234",
  "test_url": "https://my.survey.com?survey_id=1234&test=1",
  "field_time": 10,
  "qualifications": [
    {
      "qualification_code": 213,
      "range_sets": [
        {
          "from": 50000,
          "to": 100000,
          "units": 321
        }
      ]
    }
  ],
  "quotas": [
    {
      "buyer_quota_id": "qb14",
      "required_count": 200,
      "criteria": [{"qualification_code": 213,"range_sets": [{"from": 50000,"to": 75000,"units": 321}]}]
    },
    {
      "buyer_quota_id": "qb15",
      "required_count": 300,
      "criteria": [{"qualification_code": 213,"range_sets": [{"from": 50000,"to": 100000,"units": 321}]}]
    }
  ]
}

Result

Response Code

400

Response Body

{ "ps_api_response_code": <Appropriate Error Code>, "ps_api_response_message": <Appropriate Message>}