# Monigo

## Docs

- [Create a customer](https://docs.monigo.co/api-reference/customers/create-a-customer.md): Creates a new customer scoped to the authenticated organisation
- [Delete a customer](https://docs.monigo.co/api-reference/customers/delete-a-customer.md): Permanently deletes a customer record
- [Get a customer](https://docs.monigo.co/api-reference/customers/get-a-customer.md): Returns a customer by their Monigo UUID. If the ID is not a valid UUID or no customer is found, falls back to an external_id lookup scoped to the authenticated organisation.
- [List customers](https://docs.monigo.co/api-reference/customers/list-customers.md): Returns all customers belonging to the authenticated organisation
- [Update a customer](https://docs.monigo.co/api-reference/customers/update-a-customer.md): Updates the name, email, or metadata of an existing customer
- [Get a replay job (API key)](https://docs.monigo.co/api-reference/events-replay/get-a-replay-job-api-key.md): Returns the status and progress of a single replay job.
- [Initiate an event replay (API key)](https://docs.monigo.co/api-reference/events-replay/initiate-an-event-replay-api-key.md): Re-processes raw events in the given time window through current payout rules.
- [Ingest usage events](https://docs.monigo.co/api-reference/ingestion/ingest-usage-events.md): Ingest usage events. Requires an API key with the 'ingest' scope. Events are validated and published to the processing pipeline.
- [Finalize an invoice](https://docs.monigo.co/api-reference/invoices/finalize-an-invoice.md): Transitions an invoice from draft to finalized state
- [Generate an invoice](https://docs.monigo.co/api-reference/invoices/generate-an-invoice.md): Generates a new invoice for the given subscription
- [Get an invoice](https://docs.monigo.co/api-reference/invoices/get-an-invoice.md): Returns a single invoice by its ID
- [List invoices](https://docs.monigo.co/api-reference/invoices/list-invoices.md): Returns all invoices, with optional filtering by status or customer
- [Void an invoice](https://docs.monigo.co/api-reference/invoices/void-an-invoice.md): Marks an invoice as void, making it no longer payable
- [Create a metric](https://docs.monigo.co/api-reference/metrics/create-a-metric.md): Creates a new usage metric for tracking billable events
- [Delete a metric](https://docs.monigo.co/api-reference/metrics/delete-a-metric.md): Permanently deletes a billing metric record
- [Get a metric](https://docs.monigo.co/api-reference/metrics/get-a-metric.md): Returns a single billing metric by its ID
- [List metrics](https://docs.monigo.co/api-reference/metrics/list-metrics.md): Returns all billing metrics belonging to the authenticated organisation
- [Update a metric](https://docs.monigo.co/api-reference/metrics/update-a-metric.md): Updates the configuration of an existing billing metric
- [Create a payout account](https://docs.monigo.co/api-reference/payout-accounts/create-a-payout-account.md): Creates a new payout account linked to the specified customer
- [Delete a payout account](https://docs.monigo.co/api-reference/payout-accounts/delete-a-payout-account.md): Permanently deletes a payout account record
- [Get a payout account](https://docs.monigo.co/api-reference/payout-accounts/get-a-payout-account.md): Returns a single payout account by its ID
- [List payout accounts](https://docs.monigo.co/api-reference/payout-accounts/list-payout-accounts.md): Returns all payout accounts belonging to the specified customer
- [Update a payout account](https://docs.monigo.co/api-reference/payout-accounts/update-a-payout-account.md): Updates the details of an existing payout account
- [Create a plan](https://docs.monigo.co/api-reference/plans/create-a-plan.md): Creates a new billing plan with optional price tiers
- [Delete a plan](https://docs.monigo.co/api-reference/plans/delete-a-plan.md): Permanently deletes a billing plan record
- [Get a plan](https://docs.monigo.co/api-reference/plans/get-a-plan.md): Returns a single billing plan by its ID
- [List plans](https://docs.monigo.co/api-reference/plans/list-plans.md): Returns all billing plans belonging to the authenticated organisation
- [Update a plan](https://docs.monigo.co/api-reference/plans/update-a-plan.md): Updates the configuration and pricing of an existing billing plan
- [Create a subscription](https://docs.monigo.co/api-reference/subscriptions/create-a-subscription.md): Creates a new subscription linking a customer to a plan. A customer may have one active subscription per plan type — one collection and one payout — but not two of the same type. Returns 409 if the customer already has an active subscription of the same plan type.
- [Delete a subscription](https://docs.monigo.co/api-reference/subscriptions/delete-a-subscription.md): Cancels and removes a subscription record
- [Get a subscription](https://docs.monigo.co/api-reference/subscriptions/get-a-subscription.md): Returns a single subscription by its ID
- [List subscriptions](https://docs.monigo.co/api-reference/subscriptions/list-subscriptions.md): Returns all subscriptions, with optional filtering by customer, plan, or status
- [Update subscription status](https://docs.monigo.co/api-reference/subscriptions/update-subscription-status.md): Changes the status of a subscription (e.g. active, paused, cancelled)
- [Query usage rollups (API key)](https://docs.monigo.co/api-reference/usage/query-usage-rollups-api-key.md): Returns per-customer, per-metric usage rollups for the organisation scoped to the API key, with optional filters.
- [Create a virtual account](https://docs.monigo.co/api-reference/wallets/create-a-virtual-account.md): Provisions a dedicated bank account (via Paystack, Flutterwave, or Monnify) that auto-credits the wallet on deposit
- [Credit a wallet](https://docs.monigo.co/api-reference/wallets/credit-a-wallet.md): Adds funds and records double-entry ledger entries
- [Debit a wallet](https://docs.monigo.co/api-reference/wallets/debit-a-wallet.md): Removes funds and records double-entry ledger entries. Returns 402 if balance is insufficient.
- [Get a wallet](https://docs.monigo.co/api-reference/wallets/get-a-wallet.md): Returns a wallet by UUID with its linked virtual accounts
- [Get or create a wallet](https://docs.monigo.co/api-reference/wallets/get-or-create-a-wallet.md): Retrieves an existing wallet for the customer/currency pair or creates one
- [List customer wallets](https://docs.monigo.co/api-reference/wallets/list-customer-wallets.md): Returns all wallets belonging to the specified customer
- [List virtual accounts](https://docs.monigo.co/api-reference/wallets/list-virtual-accounts.md): Returns all virtual bank accounts linked to the specified wallet
- [List wallet transactions](https://docs.monigo.co/api-reference/wallets/list-wallet-transactions.md): Returns paginated ledger entries (transaction history) for the specified wallet
- [List wallets](https://docs.monigo.co/api-reference/wallets/list-wallets.md): Returns all wallets belonging to the authenticated organisation, optionally filtered by customer_id
- [Billing Cycle](https://docs.monigo.co/concepts/billing-cycle.md): How billing periods work, what happens at period end, and how invoices are triggered.
- [Data Model](https://docs.monigo.co/concepts/data-model.md): The seven core entities in Monigo and how they relate to each other.
- [Usage Alerts](https://docs.monigo.co/concepts/usage-alerts.md): How Monigo's alerting engine evaluates thresholds and delivers notifications.
- [Authentication](https://docs.monigo.co/getting-started/authentication.md): How API keys work in Monigo, including test vs live mode.
- [Test vs Live Mode](https://docs.monigo.co/getting-started/environments.md): Understanding Monigo's dual-environment model.
- [Quickstart](https://docs.monigo.co/getting-started/quickstart.md): Build a complete billing loop — customer, metric, plan, subscription, and first invoice — in under 10 minutes.
- [Customer Portal](https://docs.monigo.co/guides/customer-portal.md): Give your customers a self-service billing page — hosted by Monigo or embedded in your product.
- [Embedding the Portal](https://docs.monigo.co/guides/embedding-the-portal.md): Drop Monigo's customer portal into your own React, Vue, Svelte, or Flutter app — no iframes, no auth flow to write.
- [Event-Driven Payouts](https://docs.monigo.co/guides/event-driven-payouts.md): Automate payments to drivers, creators, and partner businesses.
- [Idempotency & Replayability](https://docs.monigo.co/guides/idempotency.md): How Monigo guarantees correctness even when things go wrong.
- [Invoice Lifecycle](https://docs.monigo.co/guides/invoice-lifecycle.md): How invoices move from draft to finalized to paid — and when to void them.
- [Marketplace Platforms](https://docs.monigo.co/guides/marketplace-platforms.md): Bill sellers, collect commissions, and pay out earnings for an auction or listing marketplace like eBay.
- [Metering](https://docs.monigo.co/guides/metering.md): Accurately track usage across your product with Monigo's event ingestion API.
- [Prepaid Billing](https://docs.monigo.co/guides/prepaid-billing.md): Charge customers from a wallet balance at period-end instead of issuing a payment request. Subscriptions pause automatically when balance runs low and resume when funds are added.
- [Pricing Models](https://docs.monigo.co/guides/pricing-models.md): A complete reference for every pricing model Monigo supports, with examples in the REST API, Go SDK, and JavaScript SDK.
- [Subscription Lifecycle](https://docs.monigo.co/guides/subscription-lifecycle.md): How subscriptions start, pause, resume, and cancel — and what each transition means for billing.
- [Usage Alerts](https://docs.monigo.co/guides/usage-alerts.md): Set up threshold-based alerts on usage metrics, costs, and wallet balances.
- [Usage-Based Billing](https://docs.monigo.co/guides/usage-based-billing.md): Move from flat-rate subscriptions to per-unit pricing with Monigo.
- [Wallet Management](https://docs.monigo.co/guides/wallet-management.md): Create and manage customer wallets, credit and debit balances, view transaction history, and provision virtual bank accounts for automatic top-ups.
- [Flutterwave](https://docs.monigo.co/integrations/flutterwave.md): Connect your Flutterwave account to Monigo for billing and payouts.
- [Monnify](https://docs.monigo.co/integrations/monnify.md): Connect your Monnify account for virtual account generation and collections.
- [Paystack](https://docs.monigo.co/integrations/paystack.md): Connect your Paystack account to Monigo for billing and payouts.
- [QuickBooks](https://docs.monigo.co/integrations/quickbooks.md): Sync Monigo invoices and payout bills to QuickBooks Online automatically.
- [Webhooks](https://docs.monigo.co/integrations/webhooks.md): Receive real-time event notifications from Monigo.
- [What is Monigo?](https://docs.monigo.co/introduction.md): Usage-based billing and event-driven payouts infrastructure for African platforms.
- [Go SDK](https://docs.monigo.co/sdks/go.md): The official Go client library for the Monigo API. Zero dependencies, idiomatic design.
- [JavaScript SDK](https://docs.monigo.co/sdks/javascript.md): The official JavaScript/TypeScript client library for the Monigo API. Zero dependencies, works in Node.js, browsers, and edge runtimes.

## OpenAPI Specs

- [public-openapi](https://docs.monigo.co/api-reference/public-openapi.yaml)
- [openapi](https://docs.monigo.co/api-reference/openapi.json)