Skip to main content
GET
/
core
/
companies
List Companies
curl --request GET \
  --url https://api.integrations.commenda.io/v4/core/companies \
  --header 'api_key: <api-key>'
{
  "data": {
    "companies": [
      {
        "id": 496,
        "inviteLinkId": "88ff4683-ed41-478a-85be-4ab78836e95b",
        "companyId": 496,
        "companyName": "Test tewtwe",
        "integration": "NETSUITE",
        "integrationCategory": "ACCOUNTING",
        "integrationEntityId": null,
        "connectionStatus": "HEALTHY",
        "syncStatus": "IDLE",
        "hasActiveSync": false,
        "lastSynced": "2026-05-20T07:11:00.759Z",
        "syncFrom": null,
        "createdAt": "2026-05-20T07:09:44.139Z",
        "dataModelConfigs": [
          {
            "dataModel": "TAX_RATE",
            "category": "ACCOUNTING",
            "enabled": true,
            "scopeAccess": {
              "READ": true,
              "CREATE": false,
              "DELETE": false,
              "UPDATE": false
            },
            "frequency": "WEEKLY",
            "interval": 2,
            "syncFrom": null,
            "isOverridden": false,
            "isChild": false
          },
          {
            "dataModel": "ACCOUNT",
            "category": "ACCOUNTING",
            "enabled": true,
            "scopeAccess": {
              "READ": true,
              "CREATE": false,
              "DELETE": false,
              "UPDATE": false
            },
            "frequency": "WEEKLY",
            "interval": 2,
            "syncFrom": null,
            "isOverridden": false,
            "isChild": false
          }
        ],
        "connection": {
          "id": "496_NETSUITE",
          "createdAt": "2026-05-20T07:10:02.217Z",
          "updatedAt": "2026-05-20T07:11:00.759Z",
          "companyId": 496,
          "organisationId": 1,
          "integrationType": "NETSUITE",
          "integrationEntityId": null,
          "category": "ACCOUNTING",
          "status": "HEALTHY",
          "syncStatus": "IDLE",
          "syncResumeAt": null,
          "lastSynced": "2026-05-20T07:11:00.759Z",
          "variables": {
            "date_format": "D/M/YYYY HH:mm",
            "organization_id": "11657842"
          }
        }
      }
    ],
    "count": 1,
    "next": null
  },
  "request_id": "42e80f7a-1b5d-4e86-a87e-6d58d72d952e"
}

Documentation Index

Fetch the complete documentation index at: https://integrations.docs.commenda.io/llms.txt

Use this file to discover all available pages before exploring further.

List companies connected to your organization. Results are ordered by creation time (newest first) and paginated with a numeric cursor.

​
Query Parameters

ParameterTypeDefaultDescription
limitinteger50Page size (max 100).
cursorinteger—Return companies after this company ID (rootfi_id).
searchstring—Match company name (case-insensitive) or numeric company ID.
connectionStatusenum—Filter by connection health (HEALTHY, DISCONNECTED, EXPIRED, PENDING, RATE_LIMIT_EXCEEDED).
integrationenum—Filter by integration type (e.g. NETSUITE, QUICKBOOKS).
integrationCategoryenum—Filter by category (ACCOUNTING, PAYMENTS, ECOMMERCE).
syncStateenum—IDLE or SYNCING.

​
Response

Returns { data: { companies, count, next }, request_id }.
FieldTypeDescription
companiesarrayArray of company objects.
countintegerTotal companies matching the filter (not just this page).
nextinteger | nullCursor for the next page (last company ID returned), or null.

Authorizations

​
api_key
string
header
required

Query Parameters

​
limit
integer

Maximum number of companies to return. Default 50, max 100.

Required range: 1 <= x <= 100
​
cursor
integer

Return companies after this company ID (rootfi_id).

Required range: x >= 1
​
search
string

Case-insensitive match on company name or numeric company ID.

​
connectionStatus
enum<string>

Filter by connection health.

Available options:
HEALTHY,
DISCONNECTED,
EXPIRED,
PENDING,
RATE_LIMIT_EXCEEDED
​
integration
enum<string>

Filter by integration type. V4-supported integration types only.

Available options:
STRIPE,
NETSUITE,
XERO,
ZOHO_BOOKS,
WAFEQ,
QUICKBOOKS,
QUICKBOOKS_SANDBOX,
BIG_COMMERCE,
WOO_COMMERCE,
OODOO_ACCOUNTING,
SHOPIFY,
FRESHBOOKS
​
integrationCategory
enum<string>

Filter by integration category. V4-supported integration categories only.

Available options:
ACCOUNTING,
PAYMENTS,
ECOMMERCE
​
syncState
enum<string>

Filter by company sync activity (IDLE or SYNCING).

Available options:
IDLE,
SYNCING

Response

Paginated company list.

​
request_id
string
required
​
data
ListCompaniesResponse · object
required