API Documentation

Complete reference for integrating Meridian Data into your application.

Authentication

All API requests require an API key. Pass your key as the X-API-Key header.

Find your API key

curl -H "X-API-Key: mrd_live_xxx..." https://api.meridiandata.io/v1/courts/wait-times

Base URL

https://api.meridiandata.io/v1

All endpoints are relative to this base URL.

Endpoints

GET/courts/wait-times

Retrieve court wait times by case type, jurisdiction, and time period.

Query Parameters

case_type (string, optional) — small_claims, fast_track, multi_track, crown

metric (string, optional) — median or p90

from (date, optional) — YYYY-MM-DD format

to (date, optional) — YYYY-MM-DD format

limit (integer, optional) — max 500, default 100

Example Request

curl -X GET "https://api.meridiandata.io/v1/courts/wait-times?case_type=fast_track&metric=median&from=2024-01-01&to=2024-03-31&limit=50" \
  -H "X-API-Key: mrd_live_xxx..."

Example Response

{
  "status": "success",
  "data": [
    {
      "circuit": "London",
      "case_type": "fast_track",
      "period": "Q1 2024",
      "metric": "median",
      "wait_weeks": 42,
      "cases_processed": 8234,
      "trend": -3.2
    },
    {
      "circuit": "South East",
      "case_type": "fast_track",
      "period": "Q1 2024",
      "metric": "median",
      "wait_weeks": 38,
      "cases_processed": 6891,
      "trend": -1.8
    }
  ],
  "pagination": {
    "total": 28,
    "limit": 50,
    "offset": 0
  }
}

GET/roadworks/permitsComing soon

Access active roadwork permits and traffic impact data. Currently in beta.

Rate Limits

Plan	Requests/Day	Requests/Minute
Starter	1,000	25
Pro	10,000	250
Enterprise	Custom	Custom

Rate limit headers are included in every response: X-RateLimit-Remaining and X-RateLimit-Reset.

Error Codes

Code	Message	Resolution
401	Unauthorized	Invalid or missing API key
429	Too Many Requests	Rate limit exceeded, retry after reset time
500	Internal Server Error	Server error, try again shortly

Code Examples

cURL

curl -X GET "https://api.meridiandata.io/v1/courts/wait-times?case_type=fast_track&metric=median" \
  -H "X-API-Key: mrd_live_xxx..."

Python

import requests

api_key = "mrd_live_xxx..."
base_url = "https://api.meridiandata.io/v1"

response = requests.get(
    f"{base_url}/courts/wait-times",
    headers={"X-API-Key": api_key},
    params={
        "case_type": "fast_track",
        "metric": "median",
        "limit": 50
    }
)

data = response.json()
print(data["data"])