Developer Platform

Build. Automate. Ship.

REST API with 26 endpoints. AI Agent with natural language. API keys with granular permissions. OpenAPI 3.1.0 spec. Your billing infrastructure, fully programmable.

View API DocsGet API Key

Get started in seconds

1.

Create API Key

Dashboard > Developers > New Key

2.

Set Header

Authorization: Bearer sk_live_...

3.

First Call

curl api.corebill.io/v1/companies

[01]

Full REST API

26 endpoints across 6 resources. CRUD operations on customers, invoices, quotes, projects, and tasks.

POST/v1/invoices
curl -X POST https://api.corebill.io/v1/invoices \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"customer_id": "cus_a1b2c3d4",
"items": [{
"name": "Website Redesign",
"quantity": 1,
"unit_price": 5000
}]
}'
[02]

AI Agent

Natural language interface to your billing data. Create invoices, manage clients, run analytics -- just by asking.

Create an invoice for Acme, $5,000 for Q1 consulting

Done. Invoice INV-2026-000042 created.

Invoice Created

Acme Corporation

Q1 Consulting

Total: $5,000.00

[03]

Granular Permissions

Three permission levels for every API key. Read-only for dashboards, write for automation, admin for full control.

readView customers, invoices, quotes, and projects
writeCreate and update resources
adminDelete resources, manage settings

API

Every resource at your fingertips.

26 endpoints, consistent patterns, predictable responses.

GET

/v1/customers

List customers

POST

/v1/customers

Create customer

GET

/v1/customers/:id

Get customer

PATCH

/v1/customers/:id

Update customer

DELETE

/v1/customers/:id

Delete customer

Predictable by design.

Every entity uses typed ID prefixes. Instantly know what you're working with.

com_

Companies

cus_

Customers

inv_

Invoices

quo_

Quotes

pro_

Projects

tsk_

Tasks

key_

API Keys

AI Agent

API + AI. The best of both worlds.

Every API endpoint is also an AI tool. Talk to your billing data in natural language, or automate with code. Same result, your choice.

REST API
POST/v1/customers
curl -X POST \
https://api.corebill.io/v1/customers \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Corp",
"email": "contact@acme.com"
}'
AI Agent

Add a new customer Acme Corp, email contact@acme.com

Done. Customer cus_a1b2c3d4 created.

Customer Created

Acme Corp

contact@acme.com

cus_a1b2c3d4

MCP Server

Available

Connect Corebill to any MCP-compatible AI client. Manage customers, invoices, quotes, and your entire catalog from Claude Desktop, Cursor, Windsurf, or any MCP client.

Install via npm

npx corebill-mcp
Claude DesktopCursorWindsurfCustom Client

claude_desktop_config.json

{
"mcpServers": {
"corebill": {
"command": "npx",
"args": ["-y", "corebill-mcp"],
"env": {
"COREBILL_API_KEY":
"sk_...",
"COREBILL_COMPANY_ID":
"com_..."
}
}
}
}

Consistent responses, every time.

Success
{
"success": true,
"data": {
"id": "cus_a1b2c3d4",
"name": "Acme Corp",
"email": "contact@acme.com",
"status": "active",
"created_at": "2026-02-12T10:30:00Z"
}
}
Error
{
"success": false,
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Customer not found",
"details": {
"customer_id": "cus_invalid"
}
}
}
OpenAPI 3.1.0JSON responsesStandard HTTP codesPagination built-in

Ready to automate your billing?

Start building with the Corebill API in minutes. Free tier included.

Get API KeyRead the Docs