API Documentation

Introduction

QNAS provides developers access to Qatar's zone, street, and building data with polygon and location precision via an open RESTful API. This documentation details available endpoints, headers, request/response structures, and error formats.

Base URL

https://qnas.qa/

Authentication

All external API requests must include the following HTTP headers:

X-Token: your-api-token
X-Domain: your-registered-domain
Accept: application/json

Register to request your token.

Available Endpoints

  • GET /get_zones
    Returns list of zones (English + Arabic).
  • GET /get_zone_polygon/{zone_number}
    Returns zone polygon boundaries.
  • GET /get_streets/{zone_number}
    Returns list of streets under the selected zone.
  • GET /get_street_polygon/{zone_number}/{street_number}
    Returns street polygon coordinates.
  • GET /get_buildings/{zone_number}/{street_number}
    Returns list of buildings with latitude/longitude.
  • GET /get_location/{zone_number}/{street_number}/{building_number}
    Returns coordinates of a specific building.

Example Request

curl -X GET \
  https://qnas.qa/get_street_polygon/69/325 \
  -H "X-Token: 7450ea7803c946b6afbf4bafc414a9d9" \
  -H "X-Domain: socialtech.qa" \
  -H "Accept: application/json"

Sample Response

{
  "status": "success",
  "http_code": 200,
  "zone_number": 69,
  "street_number": 325,
  "polygon_count": 20,
  "polygon": [
    {"lat": 25.25873, "lng": 51.49921},
    ...
  ]
}

Rate Limiting

Default limits:

  • Token-based: 60 requests/minute
  • IP-level: 3 requests every 5 seconds (for public access)

Error Format

{
  "status": "error",
  "message": "Invalid token or domain."
}

Contact

For token access or support: info@qnas.qa