An API to access data used by the UNDP Kosovo Civil Service Gender/Corruption Survey Data Visualizer.

Description

This API helps you to find and get informations based on passed data throughout the request. This data is actually being used in visualization in the UNDP Gender Corruption Visualizer.


API Usage Guide

Surveyee Distribution API

Get the answers types of corruption as they are preceived, witnessed, and participated in.

Method:

GET

URL:

/surveyee/distribution/<group>

Parameters:

Parameter Values Description
group income, gender, municipality, maritalstatus, age, education, region, ethnicity, employment.position, employment.institution, employment.level Surveyee property to group by selected values.

Sample Request:

/surveyee/distribution/gender

          
            [
              {
                "count": 398,
                "_id": "Men"
              },
              {
                "count": 402,
                "_id": "Women"
              }
            ]
          
        

Corruption Type API

Get the answers types of corruption as they are preceived, witnessed, and participated in.

Method:

GET

URL:

/corruption-type/< group-type-corruption>/group/<group>

Parameters:

Parameters Values Description
group-type-corruption embezzlement, extortion, nepotism The type of corruption
group income, gender, municipality , maritalstatus, gender, age, education, region, ethnicity, employment.position, employment.institution, and employtment.level Which interview parameter to group by.

Sample Request:

/corruption-type/embezzlement/group/gender

          
            [
              {
                "perceived": 260,
                "_id": "Men",
                "participated": 13,
                "witnessed": 19
              },
              {
                "perceived": 252,
                "_id": "Women",
                "participated": 2,
                "witnessed": 19
              }
            ]
          
        

Grouped Answers API

Get the answers to a question grouped by a given interviewee parameter.

Method:

GET

URL:

/question/<q-number>/group/<group>/disaggregate/< disaggregate-group>

URL Parameters:

Parameters Values Description
q-number 1 until 15 The number of question
group income, gender, municipality , maritalstatus, gender, age, education, region, ethnicity, employment.position, employment.institution, and employment.level Which interview parameter to group by.
disaggregate-group Which surveyee parameter to disaggregate.

Sample Request:

/question/1/group/employment.level/disaggregate/maritalstatus

          
            {
              "count": {
                "group": 10,
                "answers": 12
              },
              "answers": [
                  {
                    "a11": 3,
                    "a10": 2,
                    "a12": 3,
                    "a1": 3,
                    "a3": 3,
                    "a2": 3,
                    "a5": 2,
                    "a4": 3,
                    "a7": 3,
                    "a6": 3,
                    "a9": 3,
                    "a8": 3,
                    "_id": {
                      "disaggregate": "Divorced",
                      "group": "Government Level"
                    }
                  },
                  {
                  "a11": 1,
                    "a10": 0,
                    "a12": 1,
                    "a1": 1,
                    "a3": 1,
                    "a2": 1,
                    "a5": 1,
                    "a4": 1,
                    "a7": 1,
                    "a6": 1,
                    "a9": 0,
                    "a8": 0,
                    "_id": {
                      "disaggregate": "Divorced",
                      "group": "Municipal Level"
                    }
                  },
                  {
                    "a11": 237,
                    "a10": 164,
                    "a12": 241,
                    "a1": 164,
                    "a3": 278,
                    "a2": 242,
                    "a5": 269,
                    "a4": 278,
                    "a7": 257,
                    "a6": 288,
                    "a9": 184,
                    "a8": 186,
                    "_id": {
                      "disaggregate": "Married",
                      "group": "Government Level"
                    }
                  },
                  {
                    "a11": 206,
                    "a10": 115,
                    "a12": 220,
                    "a1": 155,
                    "a3": 263,
                    "a2": 245,
                    "a5": 263,
                    "a4": 259,
                    "a7": 258,
                    "a6": 274,
                    "a9": 142,
                    "a8": 156,
                    "_id": {
                      "disaggregate": "Married",
                      "group": "Municipal Level"
                    }
                  },
                  {
                    "a11": 12,
                    "a10": 7,
                    "a12": 11,
                    "a1": 12,
                    "a3": 15,
                    "a2": 13,
                    "a5": 15,
                    "a4": 13,
                    "a7": 14,
                    "a6": 14,
                    "a9": 10,
                    "a8": 11,
                    "_id": {
                      "disaggregate": "No answer / Refuse",
                      "group": "Government Level"
                    }
                  },
                  {
                    "a11": 3,
                    "a10": 3,
                    "a12": 3,
                    "a1": 4,
                    "a3": 4,
                    "a2": 4,
                    "a5": 4,
                    "a4": 4,
                    "a7": 4,
                    "a6": 4,
                    "a9": 3,
                    "a8": 3,
                    "_id": {
                      "disaggregate": "No answer / Refuse",
                      "group": "Municipal Level"
                    }
                  },
                  {
                    "a11": 85,
                    "a10": 47,
                    "a12": 89,
                    "a1": 50,
                    "a3": 103,
                    "a2": 94,
                    "a5": 103,
                    "a4": 105,
                    "a7": 93,
                    "a6": 108,
                    "a9": 54,
                    "a8": 57,
                    "_id": {
                      "disaggregate": "Single",
                      "group": "Government Level"
                    }
                  },
                  {
                    "a11": 30,
                    "a10": 17,
                    "a12": 35,
                    "a1": 26,
                    "a3": 44,
                    "a2": 44,
                    "a5": 44,
                    "a4": 46,
                    "a7": 44,
                    "a6": 46,
                    "a9": 22,
                    "a8": 23,
                    "_id": {
                      "disaggregate": "Single",
                      "group": "Municipal Level"
                    }
                  },
                  {
                    "a11": 3,
                    "a10": 4,
                    "a12": 3,
                    "a1": 2,
                    "a3": 5,
                    "a2": 3,
                    "a5": 3,
                    "a4": 4,
                    "a7": 5,
                    "a6": 5,
                    "a9": 2,
                    "a8": 2,
                    "_id": {
                      "disaggregate": "Widow",
                      "group": "Government Level"
                    }
                  },
                  {
                    "a11": 3,
                    "a10": 1,
                    "a12": 2,
                    "a1": 0,
                    "a3": 1,
                    "a2": 3,
                    "a5": 3,
                    "a4": 3,
                    "a7": 2,
                    "a6": 3,
                    "a9": 1,
                    "a8": 2,
                    "_id": {
                      "disaggregate": "Widow",
                      "group": "Municipal Level"
                    }
                  }
                ]
              }
          
        

© 2017 Open Data Kosovo. All rights reserved