Brainy

Brainy Prices API v2 — Dubai cost of living (proposal)

Proposal for v2 of the Brainy Prices public API (prices.brainy.ae): Dubai and UAE cost of living, read-only, per query. Not deployed. v1 (/api/v1, OpenAPI at…

Finance & banking#finance

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Proposal for v2 of the Brainy Prices public API (prices.brainy.ae): Dubai and UAE cost of living, read-only, per query.

Not deployed. v1 (/api/v1, OpenAPI at https://prices.brainy.ae/api/v1/openapi.json) stays live and unchanged. When v2 reaches general availability, v1 answers will carry a Deprecation header (RFC 9745) with a future date chosen at that time; no Sunset date is set.

Conventions (normative):

  • Envelope {meta, [context], data, links}. meta.dataset says status, dates, period, stale and historical; every row carries provenance (source, licence, dates, stale, status).
  • *_on = calendar date, *_at = logged instant. A day is never turned into an instant (a midnight placeholder becomes *_on with *_at: null).
  • Money is AED (*_aed, with the period in the name or description) as reported by the source or computed by the documented formula. No VAT treatment is implied: the VAT basis appears only where the source publishes it or a calculation declares it (telecom price_basis, DEWA vat_percent/vat_aed); otherwise it is unknown. Other currencies are explicit (currency). Unknown = null, never 0.
  • stale (our refresh failed, last good copy served) and historical (newest official period has ended) are independent.
  • Deliberate pause = HTTP 200, meta.dataset.status: paused (or row status: paused), empty data, no Retry-After: do not retry. A paused source is never served from the last good copy. 503 is only a genuine outage.
  • Selective questions only: page_size default 20, max 50; opaque cursor bound to the dataset snapshot, filters, sort, page_size, locale and an expiry (no drift or duplicates after a refresh; 400 cursor_invalid, 409 cursor_expired/snapshot_changed); at most 200 rows per query; sort allowlists; required filters where a full listing would be a bulk export. No dataset downloads or raw redistribution (legal decision on open datasets ON HOLD).
  • Calculations with personal data (relocation, DEWA bill) are POST-only with Cache-Control: no-store; nothing is stored.
  • Language: optional Accept-Language on every data operation (en default and fallback, ar, es); answers carry Content-Language, Vary: Accept-Language and meta.content_language; ETag and cursor are bound to the chosen language. Phase 1 serves English; later phases may translate labels, notices and errors only when a reviewed translation exists. Source facts (school names, grade labels, official quotes, store titles, source texts) are never translated. MCP tools may expose an optional locale argument mapped to this header.
  • Licences are per source (GET /api/v2/sources). There is no licence covering all data of this API, so info.license is intentionally absent. Tax figures are estimates, not tax advice.
  • Access: anonymous 30/min and 500/day per IP (IPv6 /64); optional free key (X-API-Key) 60/min and 1,500/day per confirmed account, shared by at most 2 active keys (two keys never double the quota; rotation does not renew it); shared enforcement across instances, no paid tier; IETF draft-11 RateLimit-Policy/RateLimit headers without account id or e-mail. Every data call counts (including 304, paused answers and validation errors). Details in ACCESS.md.
  • Every response carries its full sources (meta.dataset.sources: licence, conditions, attribution, pause status); each row's provenance.source_id and license_id resolve inside the same response.
  • Examples are mapped value by value from root's live capture (evidence/manifest.json, 27 GET, 03 Oct 2026) or from site/dist files hashed in source-manifest.json (a file rebuilt later is marked drift: true with both hashes); each example lists its x-evidence-ref (file, URL, JSON pointers, transforms) and the x-proposed-fields that do not exist in v1.
  • /api/v2/openapi.json is served without examples, x-evidence-* annotations and internal x-v1-equivalent/x-mcp-tool markers, under its own 512 KiB document limit (x-limits.openapi_document_max_bytes); this YAML is the full review copy.

Every 200 response: AED; unknown values are null, never 0. A deliberately paused dataset answers 200 with empty data.

Endpoints 56

employment

  • POSTPrivate UAE end-of-service gratuity estimate/api/v2/employment/gratuity-estimatesFederal Decree-Law No. 33 of 2021, art. 51 and Cabinet Resolution No. 1 of 2022. Estimate, not legal advice. Salary and employment dates in the JSON body…
  • POSTOvertime estimate/api/v2/employment/overtime-estimatesEstimate, not legal advice. Private JSON body only; no query inputs, no-store response and no parameter analytics.
  • POSTAnnualLeave estimate/api/v2/employment/annual-leave-estimatesEstimate, not legal advice. Private JSON body only; no query inputs, no-store response and no parameter analytics.
  • POSTFinalSettlement estimate/api/v2/employment/final-settlement-estimatesEstimate, not legal advice. Private JSON body only; no query inputs, no-store response and no parameter analytics.
  • POSTJobOffer estimate/api/v2/employment/job-offer-estimatesEstimate, not financial advice; no verdict on the offer. Private JSON body only; no query inputs, no-store response and no parameter analytics.

grocery

  • POSTCompare the cost of a grocery list across Dubai stores/api/v2/grocery/comparisons1–40 items of ≤120 characters. Stores are ranked on the same comparable subset; with one store with prices there is no ranking (outcome single_store). Product…
  • GETOfficial shop prices of essential goods (MOET)/api/v2/grocery/official-pricesUAE Ministry of Economy and Tourism Essential Goods Prices Platform, Dubai branches only, identical variants, figures unaltered. Selective: give q, category,…
  • GETIndicative online price references (paused)/api/v2/grocery/online-references?q=stringGoogle Shopping UAE references. PAUSED during a legal review: HTTP 200, status paused, empty data, no Retry-After. Do not retry; use search_grocery_products.
  • GETSearch the observed grocery catalogue/api/v2/grocery/products?q=stringSelective search by name, brand or identifier (q required). Exact products and explicit equivalents are labelled. No live web search.
  • GETGet one catalogue product with its store offers/api/v2/grocery/products/:product_idOffers per store (fresh, stale or unavailable are labelled, never ranked as current). Basket-total history is never presented as product history.
  • GETList the store offers of one product/api/v2/grocery/products/:product_id/offersOffers of one product, filterable by store and availability.
  • GETModerated shopper price reports (receipts)/api/v2/grocery/shopper-reportsAccepted reports of the last 30 days only: product, store, purchase date, pack price, promo flag. No zone, quantity or person data. Selective: product_id or…
  • GETList grocery stores and their published delivery rules/api/v2/grocery/storesMinimum orders, fee rules, sources and check dates. Unknown or expired rules are labelled; unknown fees are null.
  • GETGet one grocery store/api/v2/grocery/stores/:store_idOne store with its delivery rule.

schools

  • GETSearch Dubai private schools with KHDA tuition/api/v2/schoolsKHDA tuition as published (tuition only; grade labels as published; Year ≠ Grade). Selective: at least one of q, area, curriculum, grade, near,…
  • GETGet one school with all its KHDA fees and bus fees/api/v2/schools/:school_idAll grades as published, bus fees by zone when the operator publishes them.
  • GETOfficial uniform items and prices of a school (paused)/api/v2/schools/:school_id/uniform-itemsSupplier catalogue item by item; no kit total is invented. PAUSED while suppliers are asked for permission: 200, status paused, empty data, never served from…

housing

  • GETRegistered rent medians by community, type and bedrooms/api/v2/housing/rentsSelective: zone_id, or property_type together with bedrooms (ranking communities for one home size). Only combinations with ≥10 contracts.
  • GETRegistered sale medians by community, type, bedrooms and market/api/v2/housing/salesReady and off-plan separately; price per sq ft from the registered area. Selective: zone_id, or property_type together with bedrooms.
  • GETFind a Dubai community (DLD zone)/api/v2/housing/zones?q=stringMatches the name, Arabic name, aliases (JVC, JLT…) and DLD sub-areas. Selective: q required.
  • GETRegistered rents and sales of one community/api/v2/housing/zones/:zone_idMedian annual rent (registered Ejari contracts, last 12 months) by type and bedrooms, new vs renewal, and registered sales (ready and off-plan). Not asking…

transport

  • GETMonthly cost of a car commute (fuel + Salik)/api/v2/transport/commute-estimate?km_per_day=0.0&days_per_week=0.0&l_per_100km=1.0&fuel=super98Same formula as the website (days per month = days per week × 52/12). Inputs are not personal data, so GET is allowed. Parking, Darb and car ownership not…
  • GETModelled car commutes from communities to job hubs/api/v2/transport/commutesRoute distance and free-flow minutes from OpenStreetMap (OSRM, ODbL) and official fuel/toll tariffs. Peak travel time is not published officially: always…
  • GETUAE retail fuel prices of the current month/api/v2/transport/fuel-pricesOfficial monthly prices (AED per litre) as announced and reported by the cited publisher, change vs previous month, full-tank costs (50 and 70 L).
  • GETMonthly fuel price history/api/v2/transport/fuel-prices/historyOne row per month; months without an official figure are listed in missing_months of the current-month response, never interpolated.
  • GETDubai public parking rules (Parkin)/api/v2/transport/parkingChargeable and peak hours, zones, average hourly tariff actually paid (as reported by Parkin), seasonal cards, multi-storey and grand-event rates.
  • GETPublic transport fares (Dubai nol paused; Sharjah buses)/api/v2/transport/public-transportFares only where an official page states them. Dubai nol is paused while the official source is confirmed (row status paused).
  • GETDubai taxi tariff (DTC) and an optional trip estimate/api/v2/transport/taxi-faresStreet-hail and booked starting fares by time band, per-km, waiting and minimum fares, Sharjah surcharge; with km a one-trip estimate on the published tariff…
  • GETRoad toll tariffs (Salik; Darb paused)/api/v2/transport/tollsSalik variable pricing by day and time band. Darb (Abu Dhabi) is paused while the official source is confirmed: its row carries status paused and no figures.

utilities

  • POSTEstimate a monthly DEWA bill (household consumption)/api/v2/utilities/dewa/bill-estimatesConsumption and rent are household data: POST body only, Cache-Control no-store, never in URLs. Deposits, sewerage and other bill items not included.
  • GETDEWA electricity and water slab tariff/api/v2/utilities/dewa/tariffSlabs, fuel surcharge of the month, meter service charges as published, VAT, typical monthly bills and the housing-fee rate.

telecom

  • GETMobile and home internet plans (VAT basis per plan)/api/v2/telecom/plansRanked plans first by price per month. Plans whose price is not shown are listed as unverified and never ranked; tourist SIMs priced by days are excluded from…
  • GETOne telecom plan/api/v2/telecom/plans/:plan_idPlan terms as published, with citation and collection time.

costs

  • GETRank Dubai communities by estimated monthly living cost/api/v2/costs/areasMedian registered rent + DEWA (example use) + transport + mobile + home internet; optionally the cheapest KHDA tuition per area. While housing_fee is paused,…
  • GETLiving-cost building blocks for each emirate/api/v2/costs/emiratesRent: registered rents from Dubai Land Department open data; other emirates: status not_published. Utilities by provider, municipality housing fee, school…
  • GETLiving-cost building blocks of one emirate/api/v2/costs/emirates/:emirate_idSame row as the list for one emirate.
  • GETFixed monthly costs for three household profiles/api/v2/costs/householdsSingle (studio), couple (1-bed) and family of four (2-bed, two children in private school): each line with assumption, source and date. Fixed costs only.

relocation

  • GETFamily index: employee pay and business-owner profit after tax, home vs Dubai/api/v2/indices/familyPublished scenarios per country: typical full-time employee (single and family) with the official earnings statistics used, and business owners (home company…
  • GETCBUAE exchange rates used by the calculators/api/v2/references/fx-ratesAED per 1 unit of currency as published by the Central Bank of the UAE for the date shown.
  • POSTPrivate estimate: salary after tax at home vs in Dubai/api/v2/relocation/estimatesOfficial tax model of the home country for the tax year shown, CBUAE rate of the day, registered Dubai rent for an area and the grocery basket, projected…
  • GETHome-country tax models supported by the relocation estimate/api/v2/tax/country-modelsStatus (complete or incomplete with reason), tax year and the official sources of each model. Reference data, no personal input.

residence

  • GETFree-zone company setup packages as published/api/v2/companies/free-zonesPackages quoted from each authority (first-year or monthly price, visas included); zones without a published price or paused are listed as such. Mainland…
  • GETFees every new resident meets/api/v2/residence/common-feesMedical fitness test and mandatory health insurance band with official wording; Emirates ID paused while ICP is asked for permission; unknown costs with…
  • GETOfficial fees to move to Dubai by residence route/api/v2/residence/routesWork permit, entry permit, residence and renewal by route (job, family, golden, remote, freelance, investor), who pays and requirements, quoting the official…
  • GETOne residence route with its official fee cards/api/v2/residence/routes/:route_idSame row as the list.

health

  • GETHealth insurance rules from official texts/api/v2/health-insurance/rulesWho pays, minimum cover and fines in Dubai, each with article and source. No insurer prices. Abu Dhabi and the northern emirates are paused. Not legal advice.

electronics

  • GETElectronics prices at Dubai stores (paused)/api/v2/electronics/models?q=stringPAUSED while sources are reviewed: HTTP 200, status paused, empty data, no Retry-After, never served from the last good copy.

today

  • GETStart using Brainy Prices/api/v2/start-hereCoverage, five useful first calls with ready arguments and REST equivalents, freshness, sources and citation guidance.

meta

  • GETAPI name, version and discovery links/api/v2Discovery document. Not an MCP tool.
  • GETThis OpenAPI 3.1 document/api/v2/openapi.jsonServed as JSON. Not an MCP tool.
  • GETUpstream sources, their licence or terms and pause status/api/v2/sourcesEvery dataset names its sources; this registry gives the exact attribution, licence status (normative: confirmed, restricted, unconfirmed, paused) and…
  • GETOne upstream source and its terms/api/v2/sources/:source_idSame row as the registry.

access

  • POSTConfirm a request: key (signup) or management token (manage), shown once/api/v2/access/confirmThe token from the mail goes in the body, never in a URL. signup ⇒ the key, shown once (at most 2 active keys per confirmed account, sharing one quota; a…
  • POSTRevoke a key with a management token/api/v2/access/keys/revokeBody: management_token from a confirmed purpose=manage request (single use, expires). X-API-Key is NOT accepted for management. Not an MCP tool.
  • POSTRotate a key with a management token/api/v2/access/keys/rotateBody: management_token from a confirmed purpose=manage request (single use, expires). X-API-Key is NOT accepted for management: a data key only reads. The old…
  • POSTRequest a free API key or a key-management token (double opt-in by mail)/api/v2/access/requestsOptional: anonymous access keeps working. purpose=signup issues a key after confirmation; purpose=manage issues a single-use management token. Accepted terms…

API details

Base URL
https://prices.brainy.ae
Authentication
An API key in the X-API-Key header
Operations
56 operations on 56 pathsGET 44POST 12
Main resources
grocery 9transport 8employment 5access 4costs 4housing 4meta 4relocation 4residence 4schools 3
Response formats
application/json
Description format
OpenAPI 3.1.0, API version 2.0.0-proposal.1

How to test the Brainy Prices API v2 — Dubai cost of living (proposal) in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Brainy Prices API v2 — Dubai cost of living (proposal) collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the X-API-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Private UAE end-of-service gratuity estimate” (POST /api/v2/employment/gratuity-estimates), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Brainy Prices API v2 — Dubai cost of living (proposal)?

Proposal for v2 of the Brainy Prices public API (prices.brainy.ae): Dubai and UAE cost of living, read-only, per query. Not deployed. v1 (/api/v1, OpenAPI at… It is listed under Finance & banking and has 56 endpoints.

Who publishes the Brainy Prices API v2 — Dubai cost of living (proposal)?

It is listed from Brainy's public API description (an OpenAPI document), not published by Brainy on Swastik Codes. Anyone who controls prices.brainy.ae can claim the profile by adding a DNS TXT record.

What is the base URL of the Brainy Prices API v2 — Dubai cost of living (proposal)?

Requests go to https://prices.brainy.ae. Endpoint paths are added to this base URL.

How do I authenticate with the Brainy Prices API v2 — Dubai cost of living (proposal)?

With an API key in the X-API-Key header.

How many endpoints does the Brainy Prices API v2 — Dubai cost of living (proposal) have?

56 operations on 56 paths (44 GET, 12 POST). The largest groups are grocery, transport, employment, access.

Is forking the Brainy Prices API v2 — Dubai cost of living (proposal) free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.