# Is My Bill High?

> The world's first crowd-sourced household bill comparison platform. Compare electricity, gas, water, broadband, mobile, and insurance bills for all counties globally. Access comparative global household bill indices across 30+ countries.

## About

Is My Bill High? (IMBH) helps consumers understand whether their household bills are high, average, or low compared to similar users. It combines crowd-sourced bill data with official government statistics to produce country-level rankings and percentile-based comparisons.

- Website: https://ismybillhigh.com
- Data license: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)
- Attribution: "Source: Is My Bill High? (ismybillhigh.com)"

## Bill Categories

1. **Electricity** — Monthly electricity costs by country, adjusted for household size, solar, EV chargers
2. **Gas** — Natural gas / piped gas costs by country
3. **Water** — Water and sewerage costs by country
4. **Broadband** — Fixed internet costs by country, by speed tier and technology
5. **Mobile** — Mobile phone plan costs (prepaid and postpaid) by country
6. **Car Insurance** — Vehicle insurance premiums by country
7. **Home Insurance** — Property insurance premiums by country
8. **Health Insurance** — Health/medical insurance premiums by country

## Data Views

All data is available in three views:
- **Raw (USD)** — Median monthly cost converted to USD
- **PPP-Adjusted** — Adjusted for purchasing power parity between countries
- **Affordability** — Bill as a percentage of median household income

## How to Access the Data

### Human-Readable Pages
- Global overview: https://ismybillhigh.com/global
- Category rankings: https://ismybillhigh.com/global/{category}
  - e.g., https://ismybillhigh.com/global/electricity
- Country profiles: https://ismybillhigh.com/global/country/{code}
  - e.g., https://ismybillhigh.com/global/country/au
- Data summary (all categories, plain tables): https://ismybillhigh.com/global/data/summary

### Machine-Readable Data
- Full data tables (this file extended): https://ismybillhigh.com/llms-full.txt
- CSV/JSON exports: https://ismybillhigh.com/global/data
- OpenAPI specification: https://ismybillhigh.com/openapi.yaml

### API Endpoints (public, no auth required)
- Rankings: GET https://ismybillhigh.com/api/v1/global/rankings/{category}
- Country profile: GET https://ismybillhigh.com/api/v1/global/country/{countryCode}
- Compare countries: GET https://ismybillhigh.com/api/v1/global/compare?countries=AU,US&category=electricity
- Export (CSV/JSON): GET https://ismybillhigh.com/api/v1/global/export/{category}?format=csv
- Metadata: GET https://ismybillhigh.com/api/v1/global/metadata

## Valid Category Values

electricity, gas, water, broadband, mobile, car_insurance, home_insurance, health_insurance

## Valid Country Codes

ISO 3166-1 alpha-2 codes (e.g., AU, US, GB, NZ, IN, DE, JP, etc.)

## Data Freshness

Data is updated continuously as users submit bills. Rankings are recalculated periodically. The current data period and last update timestamp are available via the metadata endpoint.

## Contact

For data inquiries or partnerships: hello@ismybillhigh.com