Free

Public holiday calendar for a country, with sub-national calendars (free)

National public holidays in value; regional extra days are under subdivisions (ISO 3166-2). For a regional calendar applied for you, POST /v1/answers/working-days. date: null + pending_window marks a day not yet gazetted (never invented); name is stable.

get/v1/{country}/public-holidays

Request

Base URL: https://mearef.dev
URL: https://mearef.dev/v1/{country}/public-holidays
Auth: none required

Path parameters

country'ae' | 'bh' | 'il' | 'iq' | 'jo' | 'kw' | 'om' | 'qa' | 'sa' required

Example:ae

Response

Holiday calendar, plus subdivisions where the country has regions

countrystring required

ISO 3166-1 alpha-2 country code

seriesstring required

valueunknown required

unitstring

effective_fromstring date nullable required

effective_from_basis'restatement'

Optional. Absent: effective_from is the date the value became the law (a genuine change point). 'restatement': effective_from is the date the value's CURRENT LEGAL BASIS took effect (a new tax code, an annual finance law) while the value itself is older and its true origin is not primary-verifiable — a verified floor, not a change. Do not read a restatement row as the value having changed on that date.

last_confirmedstring date required

When this value was last verified against the official source

staleboolean required

True when past the expected update cycle — treat with caution

notesstring

effective_ratenumber

Optional. Combined effective rate where statutory levies stack on top of the standard rate (e.g. Ghana VAT 15% + NHIL 2.5% + GETFund 2.5% = 20%). Present only where it differs from value.

confidence_label'high' | 'medium' | 'low'

Derived from source type, verification age, stale. Rules: /label-rules

coverage_label'ready' | 'partial' | 'gap'

ready=complete, partial=limited, gap=no number. Rules: /label-rules

label_basisobject

Inputs and rule ids behind both labels

Changes

No recorded changes to this operation across all 1 revision of this API.