Secure websites use HTTPS
Scam alert
Sign up here for higher rate limits, priority support and maintenance notifications. Rate limits will be enforced on 31 December 2025.
Data is derived from the Sample Household Survey (SHS) which is conducted once every 5 years.
A household is defined based on the household-dwelling unit concept as an entire group of persons, who may or may not be related, living together in a housing unit. There may also be one-person households, where a person lives alone in a single housing unit. The household is equated with the housing unit and there is usually one household per housing unit. Subtenants or maids dwelling in the same housing unit as the lessee(s) or registered tenant(s) do not constitute part of the household.
Related datasets are grouped into a collection based on themes, topics or common attributes for easier access and exploration. All datasets within a collection are published and managed by the same agency.
This code can be used to test a sample API query. It retrieves the metadata for this collection. For a complete guide on query parameters and syntax, please refer to the API documentation. Try it out on your browser to see the response schema.