Monk API
The Monk API provides programmatic access to your billing infrastructure, enabling you to build and manage usage-based billing, subscription management, and payment collection.Base URLs
Monk has two separate APIs hosted on dedicated infrastructure:| Production | Sandbox | |
|---|---|---|
| Monk API | api.monk.com/v1 | api-sandbox.monk.com/v1 |
| Monk Events API | events-api.monk.com/v1 | events-api-sandbox.monk.com/v1 |
What You Can Do
Meters
Define billable metrics for usage-based pricing
Pricing
Create flat, tiered, and usage-based pricing configurations
Plans
Bundle pricing into reusable subscription templates
Contracts
Subscribe customers to plans
Events
Ingest usage data for metered billing
Customers
Manage customer records and metadata
Invoices
Access invoice data and payment status
Webhooks
Receive real-time notifications for billing events
Quick Start
1. Get your API key
Generate an API key from Settings → API Keys in your Monk dashboard. API keys have granular scopes — select only the permissions you need.2. Make your first request
3. Set up usage-based billing
For usage-based pricing, the typical flow is:- Create a meter to define what you’re measuring (e.g., API calls, tokens)
- Create pricing linked to the meter with your rate structure
- Create a plan bundling your pricing into a subscription template
- Create a contract to subscribe a customer to the plan
- Send events as customers consume resources
- Invoices are automatically generated with aggregated usage (minus credits)
How Usage-Based Billing Works
Understand how meters, pricing, plans, contracts, and credits fit together —
with diagrams and FAQs
New to usage-based billing? Start with our Billing for
SaaS guide for an end-to-end walkthrough.
Authentication
All requests require a Bearer token in the Authorization header:| Scope | Description |
|---|---|
usage:write | Ingest usage events |
usage:read | Read usage data |
customers:read | Read customer data |
customers:write | Create and update customers |
invoices:read | Read invoices |
contracts:read | Read contracts |
contracts:write | Create and manage contracts |
plans:read | Read plans |
plans:write | Create plans |
meters:read | Read meters |
meters:write | Create meters |
pricing:read | Read pricing configurations |
pricing:write | Create pricing configurations |
Authentication Details
Learn more about API keys, scopes, and test vs live modes
Need Help?
Guides
Step-by-step tutorials for common workflows
Support
Contact our support team