# List all companies

Returns all companies in your organization with cursor-based pagination.

### Query Parameters

- limit - Number of companies to return (1-100, default: 10)
- cursor - Opaque cursor from a previous response for pagination

### Response Structure

The response includes:
- object - Always "list"
- data - Array of company objects
- nextCursor - Cursor for the next page (null if no more results)

### Company Object

Each company includes:
- id - Featurebase internal ID (MongoDB ObjectId)
- companyId - External company ID from your system
- name - Company name
- monthlySpend - Monthly spend/revenue
- industry - Industry
- website - Company website URL
- plan - Plan/tier name
- linkedUsers - Number of users linked to this company
- companySize - Employee headcount
- lastActivity - Last activity timestamp
- customFields - Custom field values
- createdAt - Creation timestamp
- updatedAt - Last update timestamp

### Example Response

json
{
  "object": "list",
  "data": [
    {
      "object": "company",
      "id": "507f1f77bcf86cd799439011",
      "companyId": "comp_12345",
      "name": "Acme Inc",
      "monthlySpend": 5000,
      "industry": "Technology",
      "website": "https://acme.com",
      "plan": "enterprise",
      "linkedUsers": 15,
      "companySize": 250,
      "lastActivity": "2025-01-15T00:00:00.000Z",
      "customFields": { "location": "Europe" },
      "createdAt": "2025-01-01T12:00:00.000Z",
      "updatedAt": "2025-01-10T15:30:00.000Z"
    }
  ],
  "nextCursor": "eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9"
}


### Version Availability

This endpoint is only available in API version 2026-01-01.nova and newer.

Endpoint: GET /v2/companies
Version: 2026-01-01.nova
Security: bearerAuth

## Header parameters:

  - `Featurebase-Version` (string)
    API version for this request. Defaults to your organization's configured API version if not specified.
    Example: "2026-01-01.nova"

## Query parameters:

  - `limit` (integer)
    A limit on the number of companies to be returned, between 1 and 100.
    Example: 10

  - `cursor` (string)
    An opaque cursor for pagination. Use the nextCursor value from a previous response to fetch the next page of results.
    Example: "eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9"

## Response 200 fields (application/json):

  - `object` (string, required)
    Object type identifier
    Enum: "list"

  - `data` (array, required)
    Array of companies
    Example: []

  - `data.id` (string, required)
    Featurebase internal ID
    Example: "507f1f77bcf86cd799439011"

  - `data.companyId` (string, required)
    External company ID from your system
    Example: "comp_12345"

  - `data.name` (string, required)
    Company name
    Example: "Acme Inc"

  - `data.monthlySpend` (number,null, required)
    Monthly spend
    Example: 5000

  - `data.industry` (string,null, required)
    Industry
    Example: "Technology"

  - `data.website` (string,null, required)
    Company website URL
    Example: "https://acme.com"

  - `data.plan` (string,null, required)
    Plan or tier name
    Example: "enterprise"

  - `data.linkedUsers` (number,null, required)
    Number of users linked to this company
    Example: 15

  - `data.companySize` (number,null, required)
    Company employee headcount
    Example: 250

  - `data.lastActivity` (string,null, required)
    ISO date of last activity
    Example: "2025-01-15T00:00:00.000Z"

  - `data.customFields` (object)
    Custom field values
    Example: {"location":"Europe","priority":"high"}

  - `data.createdAt` (string,null, required)
    ISO date when company was created
    Example: "2025-01-01T12:00:00.000Z"

  - `data.updatedAt` (string,null, required)
    ISO date when company was last updated
    Example: "2025-01-10T15:30:00.000Z"

  - `nextCursor` (string,null, required)
    Cursor for fetching the next page (cursor-based pagination)
    Example: "eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9"

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "invalid_cursor"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 400