API Reference

Plans

The public plan catalog — free, paid and custom plans with tiers, limits and send rates.

Base URL: https://api.notideus.io. The catalog is the one unauthenticated endpoint — no API key or session needed.

GET /v1/plans

Returns the subscription catalog for the pricing page and the dashboard plan picker, straight from the DB-managed catalog (plans/plan_tiers tables).

Query params

Param	Default	Notes
`locale`	`en`	`fr` supported; unknown values fall back to `en`

name/blurb/cta/benefits are returned already localized.

Response 200 — a real response (locale=en):

{
  "free_allowances": {
    "emails": 5000,
    "contacts": 1000
  },
  "overage_per_1000_cents": 75,
  "plans": [
    {
      "key": "free",
      "kind": "free",
      "name": "Free",
      "blurb": "For side projects and first sends.",
      "cta": "Start free",
      "featured": false,
      "benefits": [
        "5,000 emails / month",
        "1,000 marketing contacts",
        "5 sending domains",
        "1 team member",
        "Visual template editor",
        "3-day analytics retention",
        "Community support"
      ],
      "email_limit": 5000,
      "contact_limit": 1000,
      "domains_limit": 5,
      "storage_gb": 1,
      "send_rate_per_second": 1,
      "tiers": null
    },
    {
      "key": "pro",
      "kind": "paid",
      "name": "Pro",
      "blurb": "For products outgrowing the free plan.",
      "cta": "Start with Pro",
      "featured": true,
      "benefits": [
        "Everything in Free, plus:",
        "15 sending domains",
        "Unlimited team members",
        "Real-time delivery tracking",
        "30-day analytics retention",
        "Email support"
      ],
      "domains_limit": 15,
      "storage_gb": 10,
      "send_rate_per_second": 10,
      "tiers": [
        {
          "emails": 50000,
          "monthly_cents": 1500,
          "annual_cents": 1200
        },
        {
          "emails": 100000,
          "monthly_cents": 3000,
          "annual_cents": 2400
        }
      ]
    },
    {
      "key": "scale",
      "kind": "paid",
      "name": "Scale",
      "blurb": "For high-volume senders.",
      "cta": "Start with Scale",
      "featured": false,
      "benefits": [
        "Everything in Pro, plus:",
        "1,000 sending domains",
        "90-day analytics retention",
        "Priority support",
        "Dedicated IP add-on"
      ],
      "domains_limit": 1000,
      "storage_gb": 50,
      "send_rate_per_second": 10,
      "tiers": [
        {
          "emails": 200000,
          "monthly_cents": 11900,
          "annual_cents": 9500
        },
        {
          "emails": 300000,
          "monthly_cents": 16900,
          "annual_cents": 13500
        },
        {
          "emails": 400000,
          "monthly_cents": 21900,
          "annual_cents": 17500
        },
        {
          "emails": 500000,
          "monthly_cents": 25900,
          "annual_cents": 20700
        },
        {
          "emails": 750000,
          "monthly_cents": 36900,
          "annual_cents": 29500
        },
        {
          "emails": 1000000,
          "monthly_cents": 47900,
          "annual_cents": 38300
        },
        {
          "emails": 1500000,
          "monthly_cents": 61900,
          "annual_cents": 49500
        },
        {
          "emails": 2000000,
          "monthly_cents": 77900,
          "annual_cents": 62300
        },
        {
          "emails": 2500000,
          "monthly_cents": 85900,
          "annual_cents": 68700
        }
      ]
    },
    {
      "key": "enterprise",
      "kind": "custom",
      "name": "Enterprise",
      "blurb": "Custom volume, custom terms.",
      "cta": "Contact us",
      "featured": false,
      "benefits": [
        "Custom sending volume",
        "99.99% SLA",
        "Dedicated IPs",
        "SSO / SAML"
      ],
      "send_rate_per_second": 10,
      "tiers": null
    }
  ],
  "contacts_tiers": [
    {
      "contacts": 5000,
      "monthly_cents": 3500
    },
    {
      "contacts": 10000,
      "monthly_cents": 7000
    },
    {
      "contacts": 25000,
      "monthly_cents": 16500
    },
    {
      "contacts": 50000,
      "monthly_cents": 23500
    },
    {
      "contacts": 100000,
      "monthly_cents": 38500
    },
    {
      "contacts": 150000,
      "monthly_cents": 58500
    },
    {
      "contacts": 200000,
      "monthly_cents": 78500
    },
    {
      "contacts": 300000,
      "monthly_cents": 109900
    },
    {
      "contacts": 400000,
      "monthly_cents": 149900
    },
    {
      "contacts": 500000,
      "monthly_cents": 189900
    },
    {
      "contacts": 600000,
      "monthly_cents": 229900
    },
    {
      "contacts": 700000,
      "monthly_cents": 269900
    },
    {
      "contacts": 800000,
      "monthly_cents": 309900
    },
    {
      "contacts": 900000,
      "monthly_cents": 349900
    },
    {
      "contacts": 1000000,
      "monthly_cents": 389900
    }
  ]
}

Fields

free_allowances — the free plan's monthly allowances (emails, contacts); always reflects the free plan (5000 emails / 1000 contacts when the catalog doesn't define one).
overage_per_1000_cents — overage price per 1000 extra emails, null unless a paid plan defines one.
plans[] — every transactional plan (free, paid, custom) ordered by catalog position:
- free plans carry email_limit / contact_limit / domains_limit and tiers: null;
- paid plans carry their purchasable tiers (emails volume → monthly_cents, optional annual_cents); plan-wide limits (domains_limit, storage_gb, send_rate_per_second) appear on any plan that defines them and are omitted when not set;
- custom plans are contact-sales only (tiers: null) and carry the same optional limits;
- every plan the catalog defines a rate for carries send_rate_per_second (nullable int, emails/second; omitted when not set) — 1 on the free plan, 10 on paid and custom plans.
contacts_tiers — the marketing contacts ladder (paid tiers only; the free allowance is never a purchasable tier).

Responses are cached ~60 s, so catalog updates take up to a minute to surface. No Stripe identifiers are included.

Edit this page

Quotas and limits

Monthly allowances, batch limits and quota errors.

Email lifecycle

Every email status and how emails move between them.