Companies

Overview

Companies represent the businesses or brands within your organization. All resources (customers, invoices, quotes, items) are scoped to a specific company.

An organization can have multiple companies, which is useful for agencies or freelancers managing multiple brands or clients.

Company Context

Every API request (except listing companies) requires a company_id query parameter:

 1GET /v1/customers?company_id=com_abc123

When using the SDK, you can set the companyId at initialization so you don't need to pass it on every call:

 1const corebill = new Corebill({
 2  apiKey: 'sk_live_...',
 3  companyId: 'com_abc123',
 4});

List Companies

Retrieve all companies accessible with your API key:

 1curl "https://api.corebill.io/v1/companies" \
 2  -H "Authorization: Bearer sk_live_your_api_key"

Response:

 1{
 2  "object": "list",
 3  "data": [
 4    {
 5      "id": "com_a1b2c3d4e5f6",
 6      "name": "My Agency",
 7      "slug": "my-agency",
 8      "currency": "USD",
 9      "invoice_prefix": "INV",
10      "quote_prefix": "QUO",
11      "logo_url": "https://...",
12      "created_at": "2026-01-15T10:00:00Z"
13    }
14  ]
15}

Key Fields