Household expenditure and income survey is one of important household surveys, which monitors household expenditure on goods and services and their consumption in addition to their income during a specific period of time. This survey is one of the main sources which the planners use to get indicators that help them to study and develop plans in various areas such as cost of living, income and expenditures and the levels of poverty, the consumption pattern of the society and community welfare levels.
Your request has been successfully submitted
You will receive a confirmation within 14days time period. If you are
having any query feel free to contact us.
having any query feel free to contact us.
Done
Send Feedback
API
| Field | Value | |||||||
|---|---|---|---|---|---|---|---|---|
| Data Provenance | Sample field Survey (household income and expenditure survey) | |||||||
| Dataset Source | Sample Field Survey (Household income and expenditure survey) | |||||||
| Format | API | |||||||
| Created | 01 Aug 2018 | |||||||
| Last updated | 19 Sep 2021 | |||||||
| Frequency of Update on Source | Every 5 year Data for the year (2014-2015) | |||||||
|
Frequency of Update to SDP
|
Every 5 year Data for the year (2014-2015)
|
|||||||
|
Expected Volume/Ingestion Cycle(Daily if Real-time)
|
||||||||
| Language | Mix~Mix~Mix~Mix~Mix~Mix~Mix~Mix~Mix~Mix | |||||||
| State | active | |||||||
| Rights | ||||||||
| License | notspecified | |||||||
| Show more | ||||||||
| Name | Description | Primary Key | Size | Datatype | Foreign Key | Range of Values | Language | Classification |
|---|---|---|---|---|---|---|---|---|
| year | Year: it is the period of time reference data / time reference data | No | 4 | Number | Mix | Open | ||
| annual_average_of_household_income | Total household income divided by number of households | No | 16 | number | Mix | OPEN | ||
| annual_average_of_income_per_capita | Total income per capita divided by the number of individuals without servants | No | 16 | number | Mix | OPEN | ||
| id | auto number | Yes | 10 | Number | Mix | OPEN | ||
| income_sources_ar | Income Sources : The cash or in-kind revenue earned by the individual or household during a specific period of time such as week, month, or year.Income consists of the following sources(? Salaries and wages.? Income from private business.? Income from property.? Transferred income (retirement pensions, transfers from non-profit institutions, subsidies, transfers from household members, social insurance, end of service indemnities, and compensations).? Self-production (self-production of food and non-food, and rent). | No | 250 | text (drop down list) | Mix | OPEN | ||
| income_sources_en | Income Sources : The cash or in-kind revenue earned by the individual or household during a specific period of time such as week, month, or year.Income consists of the following sources(? Salaries and wages.? Income from private business.? Income from property.? Transferred income (retirement pensions, transfers from non-profit institutions, subsidies, transfers from household members, social insurance, end of service indemnities, and compensations).? Self-production (self-production of food and non-food, and rent). | No | 250 | text (drop down list) | Mix | OPEN | ||
| household_type_ar | Collective Households Emirati Households Labour Camps Non-Emirati Households | No | 250 | text (drop down list) | Mix | OPEN | ||
| household_type_en | Collective Households Emirati Households Labour Camps Non-Emirati Households | No | 250 | text (drop down list) | Mix | OPEN | ||
| monthly_average_of_household_income | Total household income divided by number of households divided by 12 months per year | No | 16 | number | Mix | OPEN | ||
| monthly_average_of_income_per_capita | Total income of individuals divided by the number of individuals without servants is divided by 12 months per year | No | 16 | number | Mix | OPEN | ||
| Show more Show less | ||||||||
Dubai Pulse Data API
Access resource data via a web API with powerful query support.
The Data API can be accessed via the following actions of the CKAN action API.
-
Query
https://api.dubaipulse.gov.ae/open/dubai-statistics-center/dsc_household_expenditure_survey_income-open-api
-
End Users will receive "API Key" and "API Secret" in two separate emails on the first time Grant of a Dataset, first Purchase of a Commercial Dataset, or Purchase of an API Package. This API Key and API Secret combination should be used to generate API token and the token will need to be included in the http headers of every API call made.
Authentication Service to generate API token: https://api.dubaipulse.gov.ae/oauth/client_credential/accesstoken?grant_type=client_credentials with body 'client_id={API Key}&client_secret={API Secret}
Read the value of "access_token" from the response of the above service and use it in the header of every API call. The obtained API token is valid for certain duration (for example 30 minutes) after which a fresh token needs to be obtained.
Header Name : Authorization Value : Bearer {access_token}
-
Query Parameters
API calls can be made for full dataset result (subject to maximum results limit) or to a subset of results. Different filters can be applied on the results. Developers can use the attributes to apply a combination of filters with and/or conditions.
-
Limiting the Response Size
Developers can limit the number of records returned by an API call passing the "Limit" parameter in the call. The value of the "Limit" must be less than the allowed maximum limit.
-
Limiting the Attributes
Developers can limit the API response to specific set of attributes by passing the attribute names in the API call. The example below explains how the attributes can be specified in the API call. This feature can be used in conjunction with query parameters.
-
Curl Command Sample:
curl -X GET --header "Authorization: qMtn6xQapeouAlirfHXD7DWJFabV" "https://api.dubaipulse.gov.ae/shared/rta/rta_tram_stations-open-api"
-
Query Samples:
https://api.dubaipulse.gov.ae/shared/rta/rta_tram_stations-open-api?filter=location_id=223 AND zone_id=2 https://api.dubaipulse.gov.ae/shared/rta/rta_tram_stations-open-api?filter=location_id=223 OR zone_id=2
-
Record Limit Sample:
https://api.dubaipulse.gov.ae/shared/rta/rta_tram_stations-open-api?limit=10
-
Record Offset Sample:
https://api.dubaipulse.gov.ae/shared/rta/rta_tram_stations-open-api?offset=10
-
Record Order By Sample:
https://api.dubaipulse.gov.ae/shared/rta/rta_tram_stations-open-api?order_by=location_id
-
Attribute Limiting Sample:
https://api.dubaipulse.gov.ae/shared/rta/rta_tram_stations-open-api?filter=location_id=223 OR zone_id=2 &column=zone_id,line_name,location_id