Skip to main content

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/reports

Filter — 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.geojson

Download everything as a CSV

curl -L "https://yfp.am/api/v1/public/reports.csv?pageSize=200" -o reports.csv

Download 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.csv

Spending 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.csv

Aggregate counters

curl https://yfp.am/api/v1/public/reports/stats