Developer hub - Flexprice

Flexprice exposes one REST API, and every other developer surface is a wrapper around it. Pick the surface that fits where your code runs, then move between them freely: an object you create with the CLI shows up in the SDK, and a webhook fires no matter which client made the change.

API reference

Base URLs, auth, errors, and a live playground.

SDKs

Typed clients for Go, Python, and TypeScript.

CLI

Send events and script billing from the terminal.

AI and agents

MCP server and Agent Skills for coding agents.

UI kit

Pricing, usage, and credits components for React.

Webhooks

Signed, retried delivery for every billing event.

API tooling

OpenAPI spec, Postman, and Swagger UI.

Open source

Contribute, or self-host the community edition.

Which tool should I use?

You want to	Use	Why
Meter usage from a backend service	SDK	Typed requests, built-in retries, an async batcher for high volume
Call an endpoint the SDK does not wrap yet	REST API	The SDKs lag the API by a release; the API is always current
Poke at your account from a terminal or a CI job	CLI	JSON output, stable exit codes, and a `get`/`post`/`delete` escape hatch
Let a coding agent read or change billing data	MCP server	One tool per API operation, scoped to read, write, or delete
Give a coding agent a repeatable Flexprice workflow	Agent Skills	A skill wraps the CLI and MCP server with your own conventions
Render a pricing page or usage dashboard	UI kit	The dashboard’s own React components, fed from any data source
React to a change in Flexprice	Webhooks	Push delivery with signatures and retries instead of polling

What every Flexprice surface shares

One API key, one environment. An API key belongs to a single environment (sandbox or production) in a single region. The SDKs, CLI, and MCP server all read the same key and never need an environment flag. Create keys in the dashboard under Developers, or with the API keys endpoint. See Manage API keys for roles and scopes. Two regional base URLs. Every client is pointed at one of these, including the /v1 suffix and no trailing slash:

Region	Base URL
US	`https://us.api.flexprice.io/v1`
India	`https://api.cloud.flexprice.io/v1`

Start building in five minutes

Create an API key

In the dashboard, open Developers, click Add, and choose Read & Write. Copy the key when it is shown; it is not displayed again.

Send one usage event

flexprice init
flexprice events ingest --event_name=api_request --external_customer_id=cust_123

curl -X POST https://us.api.flexprice.io/v1/events \
  -H "x-api-key: $FLEXPRICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_name": "api_request", "external_customer_id": "cust_123"}'

import { Flexprice } from "@flexprice/sdk";

const flexprice = new Flexprice({
  serverURL: "https://us.api.flexprice.io/v1",
  apiKeyAuth: process.env.FLEXPRICE_API_KEY,
});

await flexprice.events.ingestEvent({
  eventName: "api_request",
  externalCustomerId: "cust_123",
});

Watch it land

Open the Event Debugger in the dashboard, or run flexprice events list --output json. Then follow Plan your integration for the full path to production.

Where to follow API and SDK changes

Changelog: product and API changes, with SDK releases called out
Status page: Cloud API and Admin Portal uptime and incidents
Troubleshooting hub: the first place to look when something does not line up
Community Slack: questions, feedback, and early access