Skip to main content

​
1. Get an API key

Subscribe to a plan at Polar.sh to receive your API key. Keys use the format BOROUGH_<uuid>. Free-tier search endpoints work without authentication (IP-based rate limiting applies).

​
2. Make your first request

curl -H "Authorization: Bearer BOROUGH_your-key-here" \
  "https://borough.qwady.com/v1/search/rentals?areas=120&maxPrice=4000&minBeds=1"

​
3. Understand the response

Every response follows this envelope: 
{
  "data": [...],
  "meta": {
    "total": 142,
    "page": 1,
    "perPage": 50,
    "dataAge": "2026-02-15T14:30:00Z",
    "source": "cached",
    "links": {
      "self": "/v1/search/rentals?areas=120&page=1&perPage=50",
      "first": "/v1/search/rentals?areas=120&page=1&perPage=50",
      "last": "/v1/search/rentals?areas=120&page=3&perPage=50",
      "prev": null,
      "next": "/v1/search/rentals?areas=120&page=2&perPage=50"
    }
  }
}
Key fields:
  • data — The response payload (array for lists, object for single resources)
  • meta.dataAge — When the data was last refreshed (ISO 8601)
  • meta.source — How data was served: cached, stale, or refreshing
  • meta.links — Pagination navigation URLs

​
Next steps