# Mearef Historical Series — Middle Eastern Government Reference Data

> Mearef Historical Series — Middle Eastern Government Reference Data is a paid API for AI agents from mearef.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-25).

Returns the full historical time-series for a specific government reference data series (e.g. policy rate, VAT, CPI) for one Middle Eastern country, each value cited to its official source.

## Facts

- Endpoint: GET https://mearef.dev/v1/%7Bcountry%7D/%7Bseries%7D/history?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-25
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mearef-historical-series-middle-eastern-government-reference-data-98cbdca9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IuHagL7UuGR04pXpWU26e

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mearef-historical-series-middle-eastern-government-reference-data-98cbdca9
```

Example prompt: Pull the full historical time-series for Saudi Arabia's central bank policy rate from Mearef — I want every recorded value with its cited official source and confirmation date.

## When to prefer this

Use this endpoint when you need the full chronological history of a specific government reference series (e.g. policy rate, VAT, CPI, corporate tax) for a single Middle Eastern country, rather than just the latest value. Prefer this over the single-fact or country-brief endpoints when you need trend analysis, audit trails, or time-series charting. It is especially useful for compliance research, financial modeling, and regulatory benchmarking requiring cited, verifiable historical records.

## Known failure modes

- Country not covered — endpoint returns an error or refusal if the country is outside the 9 supported Middle Eastern nations
- Series not available for the requested country — some series have partial country coverage
- Stale data warning — response may include a 'stale' flag if the value has not been reconfirmed recently
- Payment failure — x402 or MPP payment not completed results in 402 response
- Invalid country or series slug — malformed path parameters return a 4xx error

## How this service works

Middle Eastern government reference data for 9 countries as cited JSON: central-bank policy rates, VAT/GST and VAT registration thresholds, CPI, corporate, personal and withholding tax, social contributions, minimum wages, statutory interest, official FX rates, filing deadlines and public holidays (coverage varies by country). Every value carries its official source URL and last-confirmed date. Single facts $0.003; country brief (every series for one country) $0.01; cross-country compare (one series, up to 10 countries) $0.02; tax-ID and VAT-number checks $0.003; computed answers (VAT, income tax, working days, minimum-wage check) $0.01-$0.02. Pay per call in USDC on Base via x402 or MPP, no signup, or by card with credit packs or monthly plans on one key valid across all 7 regional services. Free tier: GET /catalog, plus a free email key with 50 answer calls a day, commercial use allowed. Finished answers, one cited dossier per call (supported countries vary per job; others are refused free): cost this hire (wage-floor verdict, contributions, employer cost) $0.50; charge this sale (which VAT applies, net/VAT/gross) $0.50; charge this sale certified (plus a signed VAT-rate extract) $0.75; invoice due date and statutory late interest $0.40; country evidence pack (brief plus signed extracts) $0.25; hire compare $0.75 for 2 countries, $1.00 for 3-5; next filings (VAT, PAYE, corporate-tax due dates rolled for holidays) $0.35.

Free trial: 3 computed-answer calls per day per IP on POST /v1/answers/* with header X-Free-Trial: 1 (without it, the normal x402 402; once used up, the 402 carries free_trial_resets_at). MCP answer tools use the trial automatically when no api_key is passed. Every series of the evaluation country is free. Card credit (same per-call price as x402): /pricing.

## Output

A JSON array of historical data points for the requested country and series, where each entry includes the recorded value, the period it applies to, the official government source URL, and the last-confirmed date. Coverage and depth vary by country and series.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mearef-historical-series-middle-eastern-government-reference-data-98cbdca9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mearef.dev](https://www.zero.xyz/host/mearef.dev/llms.txt)