Get current company

GET

https://api.light.inc/v1/companies/current

Returns the current company information

Authorization

Send one of these on every request. See Authentication for how to get credentials.

API key
Basic authentication header of the form Basic <api_key>, where <api_key> is your api key.
Bearer token

Response

id string · uuid
name string
invoiceEmail string
receiptEmail string
contractEmail string
salesInvoiceEmail string
logoUrl string
baseCurrency string
Note
The group (reporting) currency. Entities post in their own localCurrency; ledger amounts are carried in both.
createdAt string · date-time
updatedAt string · date-time

cURL

curl -X GET "https://api.light.inc/v1/companies/current" \
  -H "Authorization: Basic YOUR_API_KEY"

JavaScript

const res = await fetch("https://api.light.inc/v1/companies/current", {
  method: "GET",
  headers: {
    Authorization: `Basic ${process.env.LIGHT_API_KEY}`,
  },
});
const data = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.light.inc/v1/companies/current",
    headers={
        "Authorization": f"Basic {os.environ['LIGHT_API_KEY']}",
    },
)
data = res.json()

Example responseGenerated

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "string",
  "invoiceEmail": "string",
  "receiptEmail": "string",
  "contractEmail": "string",
  "salesInvoiceEmail": "string",
  "logoUrl": "string",
  "baseCurrency": "USD",
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z"
}

Generated from the schema: shapes and types are real, values are placeholders.