Yerevan for People API
This API has two parts. A public read API open to everyone with no key — browse published reports, also available as GeoJSON, CSV and NDJSON for analytics. And a partner API for submitting reports programmatically, authenticated with the X-API-Key header — create your own key in the dashboard. The reference below is generated from the live OpenAPI specification.
Quick start
No key needed. Copy, run, done — every endpoint lives under https://yfp.am/api/v1/public.
List the latest public reports (JSON)
curl https://yfp.am/api/v1/public/reportsFilter — cases sent to Road Control
curl "https://yfp.am/api/v1/public/reports?destination=ROAD_CONTROL&status=SUBMITTED"Search — a word in any language, or a body's own case number
curl "https://yfp.am/api/v1/public/reports?q=YN58-A659&locale=ru"Open in a map (GeoJSON — QGIS, Mapbox, geojson.io)
https://yfp.am/api/v1/public/reports.geojsonDownload everything as a CSV
curl -L "https://yfp.am/api/v1/public/reports.csv?pageSize=200" -o reports.csvDownload the city budget figures from the execution reports (2010–2025, thousand dram)
curl -L https://yfp.am/api/v1/public/budget/figures.csv -o budget-figures.csv…and the line names, in all three languages
curl -L https://yfp.am/api/v1/public/budget/classification.csv -o budget-classification.csvSpending by function from the city portal (2015–2018, 2020, 2022–2024, dram, not thousands)
curl -L https://yfp.am/api/v1/public/budget/spending.csv -o budget-spending.csvAggregate counters
curl https://yfp.am/api/v1/public/reports/stats