gov-salaries-data

Gov Salaries Data

📊 A public, structured dataset of government officials’ salaries — open, versioned, and community-driven.

This project provides structured JSON files listing salaries by country, year, and semester. The goal is to improve transparency and empower civic tech, journalists, and researchers.

---

🔗 Public API (GitHub Pages)

All JSON data is publicly available at:

https://cdmngz.github.io/gov-salaries-data/

Example URLs:

• /es/2025/2/data.json – officials, parties, base currency, etc.
• /es/2025/2/rates.json – exchange rates for currency conversion
• /es/index.json – available semesters per country
• /index.json – all available countries

---

📂 Data Structure

Each dataset is organized by:

/<country>/<year>/<semester>/{data.json,rates.json}

Example:

/es/2025/1/data.json /es/2025/1/rates.json

• data.json contains official records, metadata, and the baseCurrency field.
• rates.json contains conversion rates relative to that baseCurrency, including both fiat and selected cryptocurrencies.

---

💱 Currency & Rates

• Every data.json includes a baseCurrency (e.g. "USD")
• Each rates.json provides conversion rates for:
  • Major world currencies (EUR, GBP, JPY, etc.)
  • Cryptocurrencies (BTC, ETH)
• Currencies are expressed as:
  1 baseCurrency = X targetCurrency

---

🌍 Supported Countries

• 🇦🇷 Argentina (/ar)
• 🇪🇸 Spain (/es)
• (More can be added via pull requests)

---

🤝 Contributing

We welcome your help! To contribute:

1. Fork the repo
2. Add or update a data.json file in the correct folder (/<country>/<year>/<semester>/data.json)
3. Follow the expected JSON format — see the template below
4. Submit a Pull Request

✅ index.json files (used to track available periods) are auto-generated on each push.

---

🧾 Data Template

Please make sure your data.json file follows the structure shown in:

➡️ templates/data-template.json

📜 License

No rights are reserved.

This license applies to all data files in this repository, including those under /ar/, /es/, and similar country folders.

Community contributions and updates to this dataset are welcome.

This site is open source. Improve this page.