API Examples

Registry Metadata

Get Complete Registry

curl -u mams:archive2025 http://mams.devops.arabiaweather.com:8083/archives/meta

Access Registry File Directly

curl -u mams:archive2025 http://mams.devops.arabiaweather.com:8083/archives/registry.json

Both endpoints return the same registry data.

Discovering Available Runs

List Available Runs for a Model and Date

# List available runs for GFS on 2025-09-01
curl -u mams:archive2025 http://mams.devops.arabiaweather.com:8083/archives/GFS/2025/09/01/

Response: JSON directory listing showing run times (e.g., 00:00:00, 06:00:00, 12:00:00, 18:00:00)

List Models Available

curl -u mams:archive2025 http://mams.devops.arabiaweather.com:8083/archives/

List Dates for a Model

curl -u mams:archive2025 http://mams.devops.arabiaweather.com:8083/archives/GFS/

List Months for a Model and Year

curl -u mams:archive2025 http://mams.devops.arabiaweather.com:8083/archives/GFS/2025/

Archive Server Examples

Query Archive Server Directly

# Query Mams.04 archive server
curl -u mams:archive2025 http://138.201.49.117:8083/archives/GFS/2025/09/01/

Archive servers don’t have the /archives/meta endpoint.

Health Check

curl http://mams.devops.arabiaweather.com:8083/health

Response: 200 OK with plain text “OK”

Complete Workflow

# 1. Get registry to find which server has the data
curl -u mams:archive2025 http://mams.devops.arabiaweather.com:8083/archives/meta

# 2. List available dates for a model
curl -u mams:archive2025 http://mams.devops.arabiaweather.com:8083/archives/GFS/2025/

# 3. List available runs for a specific date
curl -u mams:archive2025 http://mams.devops.arabiaweather.com:8083/archives/GFS/2025/09/01/

# 4. Access specific run data (if needed)
curl -u mams:archive2025 http://mams.devops.arabiaweather.com:8083/archives/GFS/2025/09/01/12:00:00/

Authentication

All endpoints (except /health) require HTTP Basic Authentication:

Username: mams
Password: archive2025

These credentials are different from the ModMS query/web interface (modms / CLandSky on port 8081).

MAMS Nginx - Nginx service overview
MAMS Registry - Registry system documentation
MAMS Overview - MAMS system overview

ModMS

MAMS

Pinpoint

Legacy Met Tools

Geos

Geoterra

Registry Metadata

Get Complete Registry

Access Registry File Directly

Discovering Available Runs

List Available Runs for a Model and Date

List Models Available

List Dates for a Model

List Months for a Model and Year

Archive Server Examples

Query Archive Server Directly

Health Check

Complete Workflow

Authentication

​Registry Metadata

​Get Complete Registry

​Access Registry File Directly

​Discovering Available Runs

​List Available Runs for a Model and Date

​List Models Available

​List Dates for a Model

​List Months for a Model and Year

​Archive Server Examples

​Query Archive Server Directly

​Health Check

​Complete Workflow

​Authentication

​Related Documentation

Registry Metadata

Get Complete Registry

Access Registry File Directly

Discovering Available Runs

List Available Runs for a Model and Date

List Models Available

List Dates for a Model

List Months for a Model and Year

Archive Server Examples

Query Archive Server Directly

Health Check

Complete Workflow

Authentication

Related Documentation