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

API keys are scoped to a company: requests only see and change data of the key's company, with no extra parameter:

 1GET /v1/customers

With the SDK you only pass the API key:

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

List Companies

List the companies of the organization that owns your API key (read-only; the key still acts on its own company):

 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