{
  "version": "2",
  "generatedAt": "2026-11-03T22:49:39.280Z",
  "listing": {
    "slug": "meteroid-oss--meteroid",
    "name": "Meteroid",
    "tagline": "Open-source subscription and usage-based billing with an official REST API and a hosted cloud.",
    "shortTagline": "Open-source subscription billing",
    "description": "Meteroid meters usage events, models plans (flat, tiered, usage-based, hybrid), manages subscriptions and issues invoices and credit notes. The Rust monorepo self-hosts with Docker Compose or Helm under AGPL-3.0; Meteroid Cloud charges a share of managed revenue. Customers, plans, subscriptions, invoices and events are all exposed over a bearer-token REST API.",
    "capabilities": [
      "adaptable",
      "operable"
    ],
    "vertical": "invoicing-finance",
    "alternativeTo": [
      "Stripe Billing",
      "Chargebee"
    ],
    "shape": "business-app",
    "formFactor": "web-app",
    "executionModel": "deterministic",
    "provenance": "unknown",
    "codeStack": {
      "languages": [
        "Rust",
        "TypeScript"
      ],
      "frameworks": [
        "tonic (gRPC)",
        "React"
      ],
      "packageManager": "cargo",
      "database": [
        "PostgreSQL",
        "ClickHouse",
        "Kafka"
      ],
      "hostingTarget": [
        "Docker Compose",
        "Kubernetes (Helm)"
      ]
    },
    "modelStack": null,
    "repos": [
      {
        "url": "https://github.com/meteroid-oss/meteroid",
        "owner": "meteroid-oss",
        "name": "meteroid",
        "license": "AGPL-3.0",
        "stars": 1227,
        "lastCommit": "2026-08-31"
      }
    ],
    "interface": {
      "kind": "api",
      "url": "https://docs.meteroid.com/api-reference",
      "official": true,
      "hosted": "both"
    },
    "operability": "official",
    "recommendedWrapper": null,
    "reach": [
      {
        "job": "Ingest usage events and define billable metrics",
        "reachable": true,
        "evidence": "API tags Events, Metrics & Usage; spec/api/v1/openapi.json"
      },
      {
        "job": "Model plans and pricing",
        "reachable": true,
        "evidence": "API tags Plans, Products, Features"
      },
      {
        "job": "Subscription lifecycle (create, upgrade, cancel)",
        "reachable": true,
        "evidence": "API tag Subscriptions"
      },
      {
        "job": "Invoices and credit notes",
        "reachable": true,
        "evidence": "API tags Invoices, Credit Notes"
      },
      {
        "job": "Entitlements",
        "reachable": true,
        "evidence": "API tag Entitlements"
      },
      {
        "job": "Trials, coupons and add-ons",
        "reachable": true,
        "evidence": "API tags Coupons, Add-ons"
      },
      {
        "job": "Customer management",
        "reachable": true,
        "evidence": "API tag Customers"
      },
      {
        "job": "Checkout and payment collection",
        "reachable": true,
        "evidence": "API tag Checkout Sessions; Stripe connector in repo"
      },
      {
        "job": "Quotes (CPQ)",
        "reachable": null,
        "evidence": "README lists Quotes as a feature; no Quotes tag seen in the API reference index"
      },
      {
        "job": "Customer self-serve portal",
        "reachable": false,
        "evidence": "portal is a hosted UI for end customers, not an API surface"
      },
      {
        "job": "Insights and reporting",
        "reachable": false,
        "evidence": "README marks Insights & Reporting 'Coming soon'"
      }
    ],
    "editions": [
      {
        "name": "Open Source (self-hosted)",
        "price": null,
        "open": true,
        "distributions": [
          {
            "kind": "source",
            "url": "https://github.com/meteroid-oss/meteroid"
          },
          {
            "kind": "container",
            "url": "https://github.com/meteroid-oss/meteroid/tree/main/docker/deploy"
          }
        ]
      },
      {
        "name": "Cloud sandbox",
        "price": null,
        "open": false,
        "distributions": [
          {
            "kind": "hosted",
            "url": "https://app.meteroid.com/registration"
          }
        ]
      },
      {
        "name": "Cloud pay-as-you-go",
        "price": null,
        "open": false,
        "distributions": [
          {
            "kind": "hosted",
            "url": "https://meteroid.com/pricing"
          }
        ]
      },
      {
        "name": "Cloud volume plan",
        "price": {
          "amount": 219,
          "currency": "EUR",
          "period": "month"
        },
        "open": false,
        "distributions": [
          {
            "kind": "hosted",
            "url": "https://meteroid.com/pricing"
          }
        ]
      },
      {
        "name": "Enterprise",
        "price": null,
        "open": false,
        "distributions": []
      }
    ],
    "skills": {
      "kind": "contributor",
      "paths": [
        ".claude/skills/*/SKILL.md"
      ],
      "install": null,
      "note": "Repo tooling for contributors adding payment and tax providers to Meteroid."
    },
    "customization": {
      "summary": "Self-host from docker/deploy with a .env: secrets, API listen addresses, Postgres, Kafka and ClickHouse connections, SMTP and optional OAuth for Google, HubSpot and Pennylane. Pricing models, plans and metrics are data you create in the app or over the API, not files.",
      "envVars": [
        "JWT_SECRET",
        "INTERNAL_API_SECRET",
        "SECRETS_CRYPT_KEY",
        "METEROID_API_EXTERNAL_URL",
        "METEROID_REST_API_EXTERNAL_URL",
        "METEROID_PUBLIC_URL",
        "DATABASE_URL",
        "KAFKA_BOOTSTRAP_SERVERS",
        "CLICKHOUSE_HTTP_ADDRESS",
        "OBJECT_STORE_URI",
        "OPENEXCHANGERATES_API_KEY",
        "MAILER_SMTP_HOST",
        "MAILER_FROM",
        "OAUTH_GOOGLE_CLIENT_ID",
        "OAUTH_HUBSPOT_CLIENT_ID",
        "OAUTH_PENNYLANE_CLIENT_ID",
        "SVIX_JWT_SECRET"
      ],
      "configFiles": [
        ".env",
        "docker/deploy/docker-compose.yml",
        "k8s/meteroid"
      ],
      "promptFiles": [],
      "effort": "config-only",
      "editCount": 20
    },
    "useWhen": [
      "I sell a SaaS or API with usage-based pricing and want billing I own rather than a percentage-of-revenue vendor",
      "I want my agent to create customers and subscriptions and pull invoices from my product's backend"
    ],
    "accounts": [
      "Stripe (for card collection, optional)",
      "Meteroid Cloud account (cloud editions)",
      "OpenExchangeRates (multi-currency, optional)"
    ],
    "active": true,
    "lastActivity": "2026-08-31",
    "gotchas": [
      "AGPL-3.0 on the self-hosted edition",
      "Self-host needs Postgres, Kafka and ClickHouse; the compose file is described as minimal for testing",
      "Cloud pay-as-you-go is 0.5% of managed revenue, which is a different cost shape from a flat plan"
    ],
    "fit": {
      "adaptable": 2,
      "operable": 3
    },
    "evidence": {
      "formFactor": "web app plus gRPC and REST APIs; docker/deploy in repo",
      "executionModel": "billing engine, no model at runtime",
      "operability": "docs.meteroid.com/api-reference published by the Builder; OpenAPI in spec/api/v1/openapi.json",
      "effort": ".env.example in repo names the deployment surface",
      "editions": "meteroid.com/pricing: open source, sandbox, pay-as-you-go 0.5%, volume EUR 219/mo, enterprise",
      "active": "GitHub pushedAt 2026-08-31"
    },
    "confidence": {
      "formFactor": 0.9,
      "executionModel": 0.9,
      "operability": 0.9,
      "effort": 0.8,
      "reach": 0.7,
      "editions": 0.85
    },
    "openQuestions": [
      "Whether the self-hosted REST API is at parity with api.meteroid.com (the reference documents the cloud base URL)",
      "Quotes exposure over the API"
    ],
    "sources": [
      {
        "url": "https://github.com/meteroid-oss/meteroid",
        "foundBy": "sourcing:invoicing-finance:github"
      },
      {
        "url": "https://docs.meteroid.com/api-reference",
        "foundBy": "analysis:invoicing-finance"
      },
      {
        "url": "https://meteroid.com/pricing",
        "foundBy": "analysis:invoicing-finance"
      }
    ],
    "research": {
      "stage": "verified",
      "verdict": "unverified",
      "reason": "Official API with broad Reach; env-driven self-host under AGPL keeps Adaptable at 2. Open core with a revenue-share cloud.",
      "disputed": []
    },
    "url": "apps/meteroid-oss--meteroid.html",
    "coverage": "partial",
    "paid": true,
    "source": "research/verified/meteroid-oss--meteroid.json"
  }
}