Mearef

Mearef provides Middle Eastern government reference data, offering every value cited to its official source, complete with effective dates and last-verified timestamps. The platform serves a public API delivering structured data on countries, regions, and governmental entities, supporting both free and paid usage tiers. Documentation, pricing, and status information are openly available, and the service emphasizes data accuracy and transparency.

Mearef publishes 9 API contracts indexed on the APIs.io network, including Alerts API, Answers API, Certified API, and 6 more. Tagged areas include Company, Data, Government, and Middle East.

The Mearef catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

Mearef’s developer surface includes authentication, documentation, pricing, and 23 more developer resources.

Pull Mearef's APIs, OpenAPI, scores and pricing into your own code or AI agent with a free APIs.io key — sign in with GitHub, Google or LinkedIn. No form to fill in; signing in shares your email address with us (Privacy).
46.5/100 developing Agent 26/100 agent aware Full breakdown ↓
scored 2026-11-21 · rubric v0.28.1 · Show this score on your site →
AccessFreemiumSelf serve⚡ Free to try
1 published contract 1 MCP Servers 1 Agent Skills
CompanyDataGovernmentMiddle East

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-11-21 · rubric v0.28.1
Regulatory Posture applies to this provider. Its tags matched the Government & Public Sector regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.
Create-or-Update Ergonomics could not be measured. We hold no machine-readable contract for this provider to read, so there is nothing to measure a write surface against. Excluded rather than scored zero: never-measured and measured-empty are different facts. Publishing an OpenAPI is what makes this facet — and several others — scorable at all.
The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site. Kin Score badge preview for Mearef It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/mearef-dev/"><img src="https://apis.io/badge/mearef-dev/card.svg" alt="Mearef on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
7 more unmet checks in the Agent Readiness table above.
Kin Score — facets with the most composite points still available (weight × headroom):
Each check links to what satisfies it. Publish the artifact, or tell us where it already lives, and the score moves on the next scoring run.
Not sure how this applies to your stack? Ask about any one item. Kin Lane reads every question, looks at your profile and your situation, and replies with what a fix would take — scoped to that one area, priced up front, yours whether you ship it or not. Ask a question →
Ask about:
Mearef Dev · a person reads this and replies by email.
or email info@apis.io
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from the provider profile at artifacts.apis.io/mearef-dev/apis.yml: open an issue on github.com/api-evangelist/mearef-dev to ask a question or point us at an artifact you publish. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

Standards implemented 3

Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.

measured — observed by APIs.io (flavored)
measured — observed by APIs.io (documented)
measured — observed by APIs.io (published)

APIs 9

Individual APIs this provider publishes, each with its own machine-readable definition.

Mearef Alerts API

Retention. HMAC-signed webhooks, the free /v1/changes feed (past moves and freshness), and the free /v1/calendar feed (derived reverify window; next_effective_known only from cu...

Mearef Answers API

Computed answers over the reference data - VAT breakdowns, wage checks, working days, income tax, statutory interest (Actual/365 simple on the cited statutory-interest series), ...

Mearef Certified API

Series certified extracts: one value together with its citation, the fingerprint of the archived source document, and how it was verified, at GET /v1/certified/{country}/{series...

Mearef Discovery API

Machine-readable descriptions of what is served and what it costs.

Mearef Free API

No payment and no key. Public holidays for every country, the catalog, the change/freshness feed, the re-verification calendar (GET /v1/calendar), the business-day tools (GET /v...

Mearef Jobs API

The Jobs API from Mearef — 9 operation(s) for jobs.

Mearef Keys API

The Keys API from Mearef — 4 operation(s) for keys.

Mearef Reference data API

Current and historical values of a government reference series, each cited to the official instrument that set it.

Mearef x402 sellers API

Endpoints aimed at other x402 sellers, notably cross-border VAT determination for digital sales.

Scroll for all 9

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Mearef MCP Server

Remote MCP server at mearef.dev.

MCP SERVER

Agent Skills 1

Packaged agent skills for driving this provider's APIs from an AI assistant.

Mearef API pricing

Prices published by Mearef, read 2026-11-18 from mearef.dev/pricing. A free plan or tier is listed.

PlanPrice
Free tier Free
10‑credit pack $10
25‑credit pack $25
100‑credit pack $100
Starter monthly plan $19/month
Team monthly plan $49/month
Scale monthly plan $149/month
Volume tier $400

All 10 plans, limits and sources →

Pricing Plans 1

Published pricing tiers and plan structures.

Mearef Plans Pricing

10 plans

PLANS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Mearef Dev Context

7 classes · 54 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs. Counts are the severity each rule declares, not results of running them.

Mearef API Rules

63 rules · 55 error-severity 5 warn-severity 3 info-severity

SPECTRAL

OpenAPI Overlays 1

Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.

Mearef Openapi Overlay

0 actions · update

UNRECORDED

JSON Schema 5

Standalone JSON Schema definitions for this provider's data models.

AnswerReceipt

9 properties

JSON SCHEMA

CertifiedExtract

5 properties

JSON SCHEMA

SeriesValue

15 properties

JSON SCHEMA

SettlementDateAnswer

11 properties

JSON SCHEMA

StatutoryInterestAnswer

15 properties

JSON SCHEMA

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Mearef Authentication

apiKey · 3 schemes

SECURITY

Mearef Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Mearef Vulnerability Disclosure

security.txt · contact published

SECURITY

Agentic Access (API Evangelist recommendations) 1

Recommended x-agentic-access execution contracts for AI agents.

Mearef Agentic Access

44 operations · 21 acting

44 operations · 21 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Access & Security 5

Authentication, authorization, and security posture

Operate 1

Status, limits, changes, and where to get help

Commercial 4

Pricing, plans, and the legal terms of use

Company 1

The organization behind the API

Other 3

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: mearef-dev
name: Mearef
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  gated: none
  gated_source:
  - onboarding
  label: Freemium · Self-serve signup
  confidence: medium
  source:
  - plans
  - authentication
  - security
  generated: '2026-11-20'
  method: derived
image: https://mearef.dev/og.png
description: Mearef provides Middle Eastern government reference data, offering every value cited to its official source,
  complete with effective dates and last-verified timestamps. The platform serves a public API delivering structured data
  on countries, regions, and governmental entities, supporting both free and paid usage tiers. Documentation, pricing, and
  status information are openly available, and the service emphasizes data accuracy and transparency.
url: https://artifacts.apis.io/mearef-dev/apis.yml
x-type: company
x-source: harvest:mcp-registry
x-tier: profiled
x-tier-reason: enrichment pass 2026-11-18 (modular-v1; was harvest)
specificationVersion: '0.20'
created: '2026-11-18'
modified: '2026-11-18'
tags:
- Company
- Data
- Government
- Middle East
tags_raw:
- Company
- Data
- Government
- MiddleEast
- API
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: AgenticAccess
  url: agentic-access/mearef-dev-agentic-access.yml
- type: Plans
  url: plans/mearef-dev-plans-pricing.yml
- type: Spectral
  url: rules/mearef-dev-rules.yml
- type: JSONLD
  url: json-ld/mearef-dev-context.jsonld
- type: Vocabulary
  url: vocabulary/mearef-dev-vocabulary.yml
- type: AgentSkill
  url: skills/_index.yml
- type: DataModel
  url: data-model/mearef-dev-data-model.yml
- type: ErrorCatalog
  url: errors/mearef-dev-problem-types.yml
- type: Conformance
  url: conformance/mearef-dev-conformance.yml
- type: LLMsTxt
  url: llms/mearef-dev-llms.txt
- type: AgentCard
  url: a2a/mearef-dev-a2a.yml
- type: MCPServer
  url: mcp/mearef-dev-mcp.yml
- type: SecurityTxt
  url: well-known/mearef-dev-security.txt
- type: WellKnown
  url: well-known/mearef-dev-well-known.yml
- type: Hosts
  url: hosts/mearef-dev-hosts.yml
- type: Vendors
  url: vendors/mearef-dev-vendors.yml
- type: Security
  url: https://mearef.dev/.well-known/security.txt
- type: Authentication
  url: authentication/mearef-dev-authentication.yml
- type: VulnerabilityDisclosure
  url: security/mearef-dev-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/mearef-dev-domain-security.yml
- type: Website
  url: https://mearef.dev/
- type: Documentation
  url: https://mearef.dev/docs
- type: Pricing
  url: https://mearef.dev/pricing
- type: StatusPage
  url: https://mearef.dev/status
- type: TermsOfService
  url: https://mearef.dev/terms
- type: PrivacyPolicy
  url: https://mearef.dev/privacy
apis:
- aid: mearef-dev:mearef-dev-alerts-api
  name: Mearef Alerts API
  description: Retention. HMAC-signed webhooks, the free /v1/changes feed (past moves and freshness), and the free /v1/calendar
    feed (derived reverify window; next_effective_known only from current.effective_to; not a future gazette). Bind after
    the first paid series or answers call so a gazette change does not silently stale a cached value. Registering an alert
    is free; deliveries meter after a three-event trial. GET /v1/calendar is unmetered; a 402 on it is a gate bug.
  humanURL: https://mearef.dev/docs
  baseURL: https://mearef.dev
  tags:
  - Alerts
  properties:
  - type: OpenAPI
    url: openapi/mearef-dev-alerts-api-openapi.yml
- aid: mearef-dev:mearef-dev-answers-api
  name: Mearef Answers API
  description: Computed answers over the reference data - VAT breakdowns, wage checks, working days, income tax, statutory
    interest (Actual/365 simple on the cited statutory-interest series), employment cost (AE only), settlement dates - returned
    with the workings and the citations behind them. Set receipt:true on a paid answer POST to embed an optional signed answer
    receipt (kind answer_receipt) in the HTTP 200; no extra charge. That receipt is not a series certified extract.
  humanURL: https://mearef.dev/docs
  baseURL: https://mearef.dev
  tags:
  - Answers
  properties:
  - type: OpenAPI
    url: openapi/mearef-dev-answers-api-openapi.yml
  - type: JSONSchema
    url: json-schema/mearef-dev-answer-receipt-schema.json
  - type: JSONSchema
    url: json-schema/mearef-dev-statutory-interest-answer-schema.json
  - type: JSONSchema
    url: json-schema/mearef-dev-settlement-date-answer-schema.json
- aid: mearef-dev:mearef-dev-certified-api
  name: Mearef Certified API
  description: 'Series certified extracts: one value together with its citation, the fingerprint of the archived source document,
    and how it was verified, at GET /v1/certified/{country}/{series}. Answer receipts (kind answer_receipt) are a different
    artifact — they ride on paid answer POSTs when receipt:true, share the public key, and are not this extract.'
  humanURL: https://mearef.dev/docs
  baseURL: https://mearef.dev
  tags:
  - Certified
  properties:
  - type: OpenAPI
    url: openapi/mearef-dev-certified-api-openapi.yml
  - type: JSONSchema
    url: json-schema/mearef-dev-certified-extract-schema.json
- aid: mearef-dev:mearef-dev-discovery-api
  name: Mearef Discovery API
  description: Machine-readable descriptions of what is served and what it costs.
  humanURL: https://mearef.dev/docs
  baseURL: https://mearef.dev
  tags:
  - Discovery
  properties:
  - type: OpenAPI
    url: openapi/mearef-dev-discovery-api-openapi.yml
- aid: mearef-dev:mearef-dev-free-api
  name: Mearef Free API
  description: No payment and no key. Public holidays for every country, the catalog, the change/freshness feed, the re-verification
    calendar (GET /v1/calendar), the business-day tools (GET /v1/business-days/*), and the provenance ledger.
  humanURL: https://mearef.dev/docs
  baseURL: https://mearef.dev
  tags:
  - Free
  properties:
  - type: OpenAPI
    url: openapi/mearef-dev-free-api-openapi.yml
- aid: mearef-dev:mearef-dev-jobs-api
  name: Mearef Jobs API
  description: The Jobs API from Mearef — 9 operation(s) for jobs.
  humanURL: https://mearef.dev/docs
  baseURL: https://mearef.dev
  tags:
  - Job
  tags_raw:
  - Jobs
  properties:
  - type: OpenAPI
    url: openapi/mearef-dev-jobs-api-openapi.yml
  - type: JSONSchema
    url: json-schema/mearef-dev-answer-receipt-schema.json
- aid: mearef-dev:mearef-dev-keys-api
  name: Mearef Keys API
  description: The Keys API from Mearef — 4 operation(s) for keys.
  humanURL: https://mearef.dev/docs
  baseURL: https://mearef.dev
  tags:
  - Keys
  properties:
  - type: OpenAPI
    url: openapi/mearef-dev-keys-api-openapi.yml
- aid: mearef-dev:mearef-dev-reference-data-api
  name: Mearef Reference data API
  description: Current and historical values of a government reference series, each cited to the official instrument that
    set it.
  humanURL: https://mearef.dev/docs
  baseURL: https://mearef.dev
  tags:
  - Reference Data
  tags_raw:
  - Reference data
  properties:
  - type: OpenAPI
    url: openapi/mearef-dev-reference-data-api-openapi.yml
  - type: JSONSchema
    url: json-schema/mearef-dev-series-value-schema.json
- aid: mearef-dev:mearef-dev-x402-sellers-api
  name: Mearef x402 sellers API
  description: Endpoints aimed at other x402 sellers, notably cross-border VAT determination for digital sales.
  humanURL: https://mearef.dev/docs
  baseURL: https://mearef.dev
  tags:
  - x402 sellers
  properties:
  - type: OpenAPI
    url: openapi/mearef-dev-x402-sellers-api-openapi.yml
x-enrichment:
  date: '2026-11-18'
  status: enriched
  artifacts_added: 28
  pass: modular-v1
  engine: identity=local,contract=local,surfaces=local,docs=local,regulatory=local

Mearef API — frequently asked questions

Does Mearef have an API?

Yes. APIs.io lists 9 APIs from Mearef, including Mearef Alerts API, Mearef Answers API and Mearef Certified API, and 6 more.

Is there an OpenAPI specification for the Mearef API?

Yes. APIs.io indexes 9 OpenAPI specifications for Mearef, each linked for download from this page.

How do I authenticate with the Mearef API?

Mearef uses bearer-token authentication (apiKey · 3 schemes). The details are profiled on APIs.io as Mearef Authentication.

How much does the Mearef API cost?

Mearef publishes its prices; its 10‑credit pack plan is $10 as of 2026-11-18. APIs.io lists 10 pricing plans for Mearef, with each plan's price, limits and inclusions under Pricing on this page.

Does Mearef have an MCP server?

Yes. APIs.io lists 1 MCP server for Mearef: Remote MCP server at mearef.dev.

Is the Mearef API ready for AI agents?

Mearef has a Kin Score of 46.5 out of 100 (developing) and an Agent Readiness score of 26.4 (agent-aware), scored by API Evangelist on 2026-11-21.

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this
  • find_providersBrowse and filter every provider in the catalog.
  • get_provider_artifactsEvery artifact this provider publishes, grouped by type.
  • get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
  • get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
  • get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
  • get_provider_ratingPRO — composite, band, trend and facet scores.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This provider
curl "https://apis.io/api/v1/providers/mearef-dev"
All providers
curl "https://apis.io/api/v1/providers?limit=25"
Every operation they expose
curl "https://apis.io/api/v1/providers/mearef-dev/operations?limit=25"
How their score was established
curl "https://apis.io/api/v1/providers/mearef-dev/evidence"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.