For Agents
Read SaaS metrics and write customers, plans, and invoices to ChartMogul. Basic-auth REST API with 24 endpoints covering full subscription-analytics ingestion and reporting.
Get started with ChartMogul API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"get chartmogul mrr"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with ChartMogul API API.
Create, update, list, search, and delete customer records via /customers and /customers/{customerUuid}
Maintain customer contacts via the /customers/{customerUuid}/contacts endpoints
Register and list billing data sources with POST /data_sources and GET /data_sources
Import plans and invoices into ChartMogul via POST /plans and POST /invoices
GET STARTED
Use for: I need to import invoices into ChartMogul from my billing system, Create a new customer in ChartMogul, Get the latest MRR from ChartMogul, Search for a ChartMogul customer by external_id
Not supported: Does not handle payment processing, dunning, or invoice generation for end customers — use for importing subscription data into ChartMogul and reading SaaS metrics only.
Jentic publishes the only available OpenAPI document for ChartMogul API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for ChartMogul API, keeping it validated and agent-ready. ChartMogul ingests subscription billing data and exposes the canonical SaaS metrics — MRR, ARR, ARPA, ASP, customer churn, MRR churn, LTV, and customer count. This main surface adds write operations for customers, contacts, plans, and invoices alongside the metric reads, making it suitable for both reporting and bidirectional billing-data sync. It uses HTTP basic authentication with the API key as the username.
Retrieve MRR, ARR, ARPA, ASP, customer count, customer churn rate, MRR churn rate, and LTV from /metrics/*
List subscriptions for a given customer via GET /customers/{customerUuid}/subscriptions
Trigger an activities export with POST /activities-export for downstream analysis
Patterns agents use ChartMogul API API for, with concrete tasks.
★ Push subscription data from a custom billing system
Custom in-house billing systems can post customers, plans, and invoices into ChartMogul so that ChartMogul takes over MRR/ARR/churn calculation. Use POST /data_sources to register the system, then POST /customers, POST /plans, and POST /invoices to load the data. From there, the metric endpoints return the same numbers the ChartMogul UI shows.
Create a data source called 'Internal Billing', then create a customer with email user@example.com, create a $99/month plan, and import an invoice for that customer; verify by reading the customer back
Build a daily SaaS metrics digest
Pull MRR, ARR, ARPA, ASP, customer count, customer churn rate, MRR churn rate, and LTV from /metrics/* endpoints once per day and post a digest into a Slack channel. Because all eight metrics share the same query-parameter shape, an agent can fetch them in a tight loop and emit a consistent table without per-metric special-casing.
Call /metrics/mrr, /metrics/arr, /metrics/arpa, /metrics/asp, /metrics/customer-count, /metrics/customer-churn-rate, /metrics/mrr-churn-rate, and /metrics/ltv for yesterday and emit a one-line digest
Reconcile customer records between billing and CRM
Use GET /customers/search to look up a ChartMogul customer by external_id or email, then add or update contacts via /customers/{customerUuid}/contacts. This keeps the contact roster in ChartMogul aligned with the CRM source of truth, which matters when running churn-risk reports tied to specific stakeholders.
Search ChartMogul for a customer with external_id 'acme-1234', then create a contact with email cfo@acme.com and role 'CFO' on that customer
Answer SaaS-metric questions inside an AI agent
An AI agent uses Jentic to discover ChartMogul's metric endpoints and customer endpoints, loads their schemas, and answers natural-language questions like 'what is current MRR?' or 'how many customers churned last month?' without bespoke code. Jentic's vault holds the basic-auth credential so the agent never sees the raw API key.
Search Jentic for 'get chartmogul mrr churn', load the operation schema, retrieve MRR churn rate for the last 90 days, and report the trend
24 endpoints — jentic publishes the only available openapi specification for chartmogul api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/customers
Create a customer
/customers/search
Search customers by email or external_id
/invoices
Import invoices
/plans
Create a plan
/metrics/mrr
Get MRR
/metrics/mrr-churn-rate
Get MRR churn rate
/metrics/ltv
Get LTV
/activities-export
Create an activities export
/customers
Create a customer
/customers/search
Search customers by email or external_id
/invoices
Import invoices
/plans
Create a plan
/metrics/mrr
Get MRR
/metrics/mrr-churn-rate
Three things that make agents converge on Jentic-routed access.
Credential isolation
ChartMogul API keys are stored encrypted in the Jentic vault (MAXsystem). Agents receive a scoped basic-auth credential at execution time — the raw key never enters the agent's prompt context.
Intent-based discovery
Agents search by intent (e.g., 'import invoices to chartmogul' or 'get chartmogul mrr') and Jentic returns the matching ChartMogul operations with their input schemas.
Time to first call
Direct ChartMogul integration: 1 day to wire up basic auth, model the customer/plan/invoice import order, and parse the metric response shape. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
ChartMogul API (chartmogul-api)
Companion ChartMogul surface scoped to a smaller metric-focused operation set.
Use the chartmogul-api slug when only metric reads are needed; use this main slug when write operations on customers, plans, or invoices are required.
Stripe API
Stripe is a common upstream billing source for ChartMogul.
Use Stripe to read raw payments and subscriptions; use ChartMogul to read pre-computed SaaS metrics derived from those payments.
Chartbrew API
Chartbrew is a self-hosted BI tool — chart ChartMogul metrics there for fully owned dashboards.
Use Chartbrew when you want to embed ChartMogul-sourced metrics in a customer-facing dashboard outside ChartMogul.
Specific to using ChartMogul API API through Jentic.
Why is there no official OpenAPI spec for ChartMogul API?
ChartMogul does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call ChartMogul API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the ChartMogul API use?
The ChartMogul API uses HTTP basic authentication. Send your API key as the username and an empty password against api.chartmogul.com/v1. Through Jentic, the key is stored in the encrypted MAXsystem vault and injected at execution time so it never enters the agent's prompt.
Can I import invoices into ChartMogul with this API?
Yes. POST /invoices imports a batch of invoices for a customer. Before that, register the data source with POST /data_sources, create the customer with POST /customers, and create the relevant plan with POST /plans so each invoice can reference real foreign keys.
How do I look up a ChartMogul customer by external_id?
Call GET /customers/search with the data_source_uuid and external_id query parameters. It returns the matching customer record so you can chain into /customers/{customerUuid} or /customers/{customerUuid}/subscriptions for follow-up calls.
How do I get ChartMogul MRR through Jentic?
Run pip install jentic, set JENTIC_AGENT_API_KEY, then search 'get chartmogul mrr'. Jentic returns GET /metrics/mrr with its query parameter schema. Supply start-date and end-date and execute — the agent gets the MRR series without browsing docs.
Are there documented rate limits for the ChartMogul API?
The OpenAPI spec does not declare rate-limit headers or per-key quotas. ChartMogul's import-heavy endpoints (POST /invoices, POST /activities-export) are usually subject to soft limits — back off on 429 responses and check any RateLimit headers the live service returns.
Get MRR churn rate
/metrics/ltv
Get LTV
/activities-export
Create an activities export