List businesses

GET/v1/businesses

Returns the businesses of the account that you can reach.

An account can hold any number of businesses on every plan. Members other than the Owner may be limited to some businesses; this list only shows the ones your role or API key can reach.

Connectors use this call to fill their business picker and to test a connection. Results use cursor pagination. See Businesses.

Permission: businesses.view
Type: Read-only. Changes nothing.
Auth: API key, MCP token or signed-in session
Capability: list_businesses
CLI: freeinvoiceautomation business list
Available: At launch, 1 January 2027

list_businesses

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/businesses \
  --header 'Authorization: Bearer <api-key>'

{
  "data": [
    {
      "id": "0193f29e-11aa-7c3b-8d2e-5a6b7c8d9e0f",
      "legal_name": "Northwind Studio Ltd",
      "display_name": "Northwind Studio",
      "slug": "northwind-studio",
      "country": "GB",
      "base_currency": "GBP",
      "timezone": "Europe/London",
      "locale": "en-GB",
      "email": "[email protected]",
      "phone": "+44 20 7946 0000",
      "address": {
        "line1": "12 Market Street",
        "city": "London",
        "postal_code": "EC1A 1BB",
        "country": "GB"
      },
      "tax_ids": [
        {
          "type": "VAT",
          "value": "GB123456789"
        }
      ],
      "logo_attachment_id": "0193f29f-0a1b-7c2d-8e3f-4a5b6c7d8e9f",
      "created_at": "2027-01-02T08:30:00Z",
      "updated_at": "2027-01-02T08:30:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Authorizations

Authorizationstringrequired

Bearer <api-key>. An API key from Settings > API keys, or an MCP token. See Authentication.

Query Parameters

qstring

Text search over legal and display name.

limitintegerdefault:50

Page size, 1 to 200.

cursorstring

Cursor from the previous page's next_cursor.

Response

200 - application/json

dataobject[]

The businesses on this page.

next_cursorstring | null

Cursor for the next page, or null on the last page.

has_moreboolean

Whether another page exists.

Suggest edits Raise issue

Webhook eventsPrevious Get a businessNext

list_businesses

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/businesses \
  --header 'Authorization: Bearer <api-key>'

{
  "data": [
    {
      "id": "0193f29e-11aa-7c3b-8d2e-5a6b7c8d9e0f",
      "legal_name": "Northwind Studio Ltd",
      "display_name": "Northwind Studio",
      "slug": "northwind-studio",
      "country": "GB",
      "base_currency": "GBP",
      "timezone": "Europe/London",
      "locale": "en-GB",
      "email": "[email protected]",
      "phone": "+44 20 7946 0000",
      "address": {
        "line1": "12 Market Street",
        "city": "London",
        "postal_code": "EC1A 1BB",
        "country": "GB"
      },
      "tax_ids": [
        {
          "type": "VAT",
          "value": "GB123456789"
        }
      ],
      "logo_attachment_id": "0193f29f-0a1b-7c2d-8e3f-4a5b6c7d8e9f",
      "created_at": "2027-01-02T08:30:00Z",
      "updated_at": "2027-01-02T08:30:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}