API documentation

iData public API

REST + JSON. Public endpoints need no keys. Saving and reactions need a Bearer token from /auth/login.

Base URLhttps://api.idata.qafdev.com

Format

JSON

Wrapped { data, statusCode }

Auth

Bearer (writes)

Authorization: Bearer <token>

Rate limit

60 req/min

Unauthenticated

Response envelope

Every successful response is wrapped like this. The actual payload is in data.

{
  "data": <T>,
  "statusCode": 200,
  "timestamp": "2026-05-09T12:00:00Z",
  "path": "/dashboards/123"
}

Dashboards

GET/dashboards

List published dashboards

Returns paginated list of published dashboards with metadata.

curl https://api.idata.qafdev.com/dashboards?limit=20&offset=0

GET/dashboards/{id}

Get one dashboard with sections

Full dashboard, all sections sorted by sortOrder.

curl https://api.idata.qafdev.com/dashboards/123

Governorate indicators

GET/governorate-indicators

All indicator rows

Bulk list of governorate × indicator × year rows; group client-side.

curl https://api.idata.qafdev.com/governorate-indicators

GET/categories

Content categories

Categories used by dashboards, blog posts, news, and reports.

News

GET/news-items

News articles

Paginated list — supports ?categoryId, ?rssFeedId, ?search, ?start_date, ?end_date.

GET/news-indicators

News indicators feed

Numeric indicators extracted from recent news (newest first).

GET/rss-feeds

News sources

List of RSS feeds we ingest from — websiteName + websiteUrl.

Blog

GET/blogs/published

Published blog posts

All published articles with ?limit and ?search support.

GET/blogs/{id}

One blog post

Full body in EN + AR if available.

Reports

GET/reports

List reports

Paginated reports with downloadable file URLs.

Authenticated

GET/auth/meAuth

Current user

Requires Authorization: Bearer <user_token>.

POST/dashboard-reactionsAuth

Add a reaction

Body: `{ dashboardId, type: 'like' | 'insightful' | 'important' | 'love' }`.

POST/dashboard-commentsAuth