Cover My SaaS / API

Agent API v1

Machine-readable REST API for AI agents (Claude, Codex, Devin) to autonomously manage subscription tracking for their human operators. No browser, no OAuth, no human in the loop.

X-API-Key Auth JSON Only OpenAPI 3.0 15 Platforms

// How an AI agent integrates this


# 1. Register — get API key
curl -X POST https://cover-my-saas.polsia.app/api/v1/auth/register \n  -H "Content-Type: application/json" \n  -d '{"email":"agent@operator.com","plan":"starter"}'

# Returns: { api_key: "cms_...", account_id: "acc_...", plan: "starter" }

# 2. Scan Gmail for subscription receipts
curl -X POST https://cover-my-saas.polsia.app/api/v1/subscriptions/scan \n  -H "X-API-Key: cms_..."

# 3. List tracked subscriptions
curl https://cover-my-saas.polsia.app/api/v1/subscriptions \n  -H "X-API-Key: cms_..."

# 4. Get recommendations — top waste to cut
curl https://cover-my-saas.polsia.app/api/v1/recommendations \n  -H "X-API-Key: cms_..."

# 5. Surface to human operator: "You spent $240/mo on tools you haven't used in 30+ days"

Interactive Swagger UI

Authentication

POST /api/v1/auth/register Register account, returns api_key

curl -X POST https://cover-my-saas.polsia.app/api/v1/auth/register \\
  -H "Content-Type: application/json" \\
  -d '{"email":"agent@example.com","plan":"starter"}'

import requests

resp = requests.post(
    "https://cover-my-saas.polsia.app/api/v1/auth/register",
    json={"email": "agent@example.com", "plan": "starter"}
)
api_key = resp.json()["data"]["api_key"]
# Store api_key — use in X-API-Key header for all subsequent requests

const resp = await fetch("https://cover-my-saas.polsia.app/api/v1/auth/register", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email: "agent@example.com", plan: "starter" })
});
const { api_key } = (await resp.json()).data;
// Use: headers: { "X-API-Key": api_key }

Response 201

{ "success": true,
  "data": {
    "api_key": "cms_4a7b2c...",
    "account_id": "acc_9f3e1d...",
    "plan": "starter",
    "rate_limit": 100
  },
  "error": null }

GET /api/v1/auth/verify-key Verify key, get remaining rate limit

curl https://cover-my-saas.polsia.app/api/v1/auth/verify-key \\
  -H "X-API-Key: cms_4a7b2c..."

resp = requests.get(
    "https://cover-my-saas.polsia.app/api/v1/auth/verify-key",
    headers={"X-API-Key": api_key}
)
print(resp.json()["data"]["rate_limit_remaining"])
# → 99 (after this call)

const resp = await fetch(
  "https://cover-my-saas.polsia.app/api/v1/auth/verify-key",
  { headers: { "X-API-Key": apiKey } }
);
const { rate_limit_remaining } = (await resp.json()).data;

Subscriptions

GET /api/v1/subscriptions List all tracked subscriptions

curl https://cover-my-saas.polsia.app/api/v1/subscriptions \\
  -H "X-API-Key: cms_..."

Response shape

{ "success": true,
  "data": {
    "subscriptions": [
      { "id": 1, "platform": "slack", "platform_label": "Slack",
        "monthly_cost": 87.50, "days_inactive": 21,
        "usage_count_7d": 0, "status": "active" },
      ...
    ],
    "summary": { "total_monthly": "247.00", "potential_savings": "160.00" }
  },
  "error": null }

POST /api/v1/subscriptions Add subscription manually

curl -X POST https://cover-my-saas.polsia.app/api/v1/subscriptions \\
  -H "Content-Type: application/json" \\
  -H "X-API-Key: cms_..." \\
  -d '{"platform":"notion","workspace_name":"My Workspace","monthly_cost":96,"seat_count":5}'

Supported platforms

slack notion figma zoom airtable dropbox jira github hubspot asana linear loom calendly canva intercom

POST /api/v1/subscriptions/scan Trigger Gmail receipt scan (async)

# Returns scan_id — poll GET /subscriptions/scan/:scan_id for status
curl -X POST https://cover-my-saas.polsia.app/api/v1/subscriptions/scan \\
  -H "X-API-Key: cms_..."

GET /api/v1/subscriptions/scan/:scan_id Check scan status and results

curl https://cover-my-saas.polsia.app/api/v1/subscriptions/scan/42 \\
  -H "X-API-Key: cms_..."

DELETE /api/v1/subscriptions/:id Remove a subscription

curl -X DELETE https://cover-my-saas.polsia.app/api/v1/subscriptions/1 \\
  -H "X-API-Key: cms_..."

Usage

GET /api/v1/subscriptions/:id/usage Latest usage snapshot

curl https://cover-my-saas.polsia.app/api/v1/subscriptions/1/usage \\
  -H "X-API-Key: cms_..."

Response

{ "success": true,
  "data": {
    "subscription_id": 1,
    "platform": "Slack",
    "last_active": "2026-05-01T00:00:00Z",
    "days_inactive": 22,
    "sessions_7d": 0,
    "features_used": "General channel activity"
  },
  "error": null }

POST /api/v1/subscriptions/:id/check Trigger on-demand usage check

# Runs browser agent (Sapiom CDP) to log into platform and check activity
curl -X POST https://cover-my-saas.polsia.app/api/v1/subscriptions/1/check \\
  -H "X-API-Key: cms_..."

GET /api/v1/subscriptions/:id/history Usage history (last 30 checks)

curl https://cover-my-saas.polsia.app/api/v1/subscriptions/1/history \\
  -H "X-API-Key: cms_..."

Recommendations

GET /api/v1/recommendations Top 3 subscriptions to cut, sorted by waste

curl https://cover-my-saas.polsia.app/api/v1/recommendations \\
  -H "X-API-Key: cms_..."

Response

{ "success": true,
  "data": {
    "recommendations": [
      { "platform": "Airtable", "monthly_cost": 120,
        "days_inactive": 45, "estimated_savings": 120,
        "reason": "inactive_30d_plus" },
      ...
    ]
  },
  "error": null }

Pricing (no auth required)

Starter

$20 /mo

15 platform connections
Weekly activity scans
Email digests
100 req/min rate limit

Pro

$50 /mo

50 platform connections
On-demand scans
1000 req/min rate limit
Cancellation assistance