Billing

Fidemark Enterprise has three tiers, gated by your API key. The tier governs the rate limits and monthly attestation quota you can consume; nothing else about the protocol changes between tiers.

Reading your tier

Every Enterprise endpoint that returns metadata about your key includes the current tier. The simplest is GET /v1/me:

GET /v1/me
Authorization: Bearer fmk_...

{
  "key_id": "k_01H...",
  "tier": "pro",
  "quota": { "monthly": 100000, "used": 12834, "resets_at": "2026-06-01T00:00:00Z" },
  "rate_limits": { "rps": 50, "burst": 100 }
}

tier is one of free, pro, enterprise. See Rate limits for the per-tier numbers.

Subscribing

Pro and Enterprise plans are billed via Stripe. Start a checkout session by registering a billing customer for your account, then completing the checkout in the Stripe-hosted UI:

POST /v1/billing/customer
Authorization: Bearer fmk_...
Content-Type: application/json

{ "email": "[email protected]" }

The response carries a Stripe Checkout URL; redirect the user to it, or present it as a link. After the subscription becomes active, your key’s tier updates automatically (the upgrade is processed via a Stripe webhook on Fidemark’s side and propagates to the next request your key makes).

Plan changes and cancellation

Plan upgrades, downgrades, and payment-method updates happen in the Stripe Customer Portal linked from your account email. When the subscription state changes:

Subscription state	Resulting tier
active or trialing on Pro	pro
active on Enterprise	enterprise
canceled / past_due	free

Downgrades take effect at the end of the current billing period; cancellations move you to free immediately on canceled, but in-flight requests within the same billing period stay charged at your prior tier.

Quota and overage

If your monthly attestation count exceeds the tier quota, write endpoints return:

HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "error": "QUOTA_EXCEEDED",
  "message": "Monthly attestation quota exhausted. Upgrade your tier or wait for the period to reset.",
  "resets_at": "2026-06-01T00:00:00Z"
}

Verify endpoints continue to work, since reads are not metered.

Receipts and invoices

All invoices, receipts, and payment-method records live in Stripe. Use the customer-portal link sent at signup to download invoices, update tax info, or update payment methods.