Mardii API

Build AI vendor intelligence into your own systems.

REST API access to all Mardii data: AVRS scores, change feeds, pricing history, financial impact calculations. Integrate vendor risk monitoring directly into your dashboards and workflows.

Start freeSee API documentation
REST API

Complete access to Mardii intelligence.

Everything we track is available via API. Build custom dashboards, integrate with existing tools, or create automated workflows.

/api/v1/scores

AVRS Risk Scores

Current and historical AVRS scores for all providers. Updated daily at 06:00 UTC.

{
  "groq": { "score": 91, "band": "stable" },
  "openai": { "score": 54, "band": "high_risk" }
}
/api/v1/changes

Change Feed

Real-time feed of all detected vendor changes with severity classification.

{
  "provider": "openai",
  "change_type": "pricing",
  "severity": "major"
}
/api/v1/financial

Financial Impact

Calculate dollar impact of changes based on your usage patterns and spend data.

{
  "monthly_impact": "$2400",
  "annual_projection": "$28800"
}
/api/v1/providers

Provider Data

Complete provider profiles, pricing history, uptime stats, and policy changes.

{
  "name": "OpenAI",
  "uptime_30d": 99.2,
  "price_changes_12m": 8
}
/api/v1/forecast

Spend Forecasting

Risk-adjusted cost projections for 3, 6, and 12-month periods.

{
  "q1_2026": "$45200",
  "confidence_interval": "±18%"
}
/api/v1/ades

Portfolio Risk

Your AI Dependency Exposure Score and portfolio concentration analysis.

{
  "ades_score": 34,
  "max_single_vendor_impact": "67%"
}

Built for enterprise integration.

RESTful Design

Standard HTTP methods, JSON responses, predictable URLs. Works with any programming language or platform.

Authentication

API key authentication with role-based access control. Rotate keys, set expiration dates, limit endpoint access.

Rate Limiting

1000 requests/hour. Rate limit headers included in all responses.

Webhooks

Real-time notifications when changes are detected. Configure endpoints for different event types and severity levels.

Historical Data

Access up to 12 months of historical data. Pricing trends, AVRS score changes, and complete change audit trails.

99.9% Uptime SLA

Enterprise-grade reliability with guaranteed uptime. Status page monitoring and incident notifications included.
Code Examples

Get started in minutes.

Get Current AVRS Scores

curl -H "Authorization: Bearer YOUR_API_KEY"   https://api.mardii.com/v1/scores

{
  "providers": {
    "openai": {
      "score": 54,
      "band": "high_risk",
      "trend": "declining",
      "last_updated": "2026-02-23T06:00:00Z"
    },
    "groq": {
      "score": 91,
      "band": "stable",
      "trend": "stable",
      "last_updated": "2026-02-23T06:00:00Z"
    }
  }
}

Subscribe to Change Webhooks

# Configure webhook endpoint
curl -X POST   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "url": "https://your-app.com/webhooks/mardii",
    "events": ["change.pricing", "change.major"],
    "providers": ["openai", "anthropic"]
  }'   https://api.mardii.com/v1/webhooks

# Webhook payload example
{
  "event": "change.pricing",
  "provider": "openai",
  "severity": "major",
  "impact_estimate": "$2400/month",
  "detected_at": "2026-02-23T14:30:00Z"
}

Integrate AI vendor intelligence into your workflow.

Start freeTalk to our API team