<!-- Source: https://docs.vinsi.ai/api-docs/crm-companies -->
# Get Companies

List CRM companies in your organization. Send paginated=true for a paged response ({ items, total, page, pageSize, counts }) where each item includes customFieldValues keyed by custom tab ID; without it the endpoint returns a plain array of the newest 1,000 companies (lite=true returns fewer fields). Paged filters: search (name, industry, email, phone, address fields and custom field values), activeTab (all | my | ours | prospects, default all), filterType and filterIndustry (comma-separated lists), filterCreated (today | week | month | 3months), sortBy (name, industry, type, city, createdAt, updatedAt, email, phone, website, address, zip, country), sortDir (asc | desc, default desc). pageSize defaults to 25, max 100.

```http
GET https://dashboard.vinsi.ai/api/crm/companies
```

## Authentication

Send your API key in the `x-api-key` header. Create keys in the VINSI dashboard under Settings → API Keys.

## Headers

| Name | Type | Required |
|---|---|---|
| Content-Type | string | yes (application/json) |
| x-api-key | string | yes |

## Query parameters

| Name | Required | Example |
|---|---|---|
| paginated | no | true |
| page | no | 1 |
| pageSize | no | 25 |
| search | no | acme |
| activeTab | no | all |
| filterType | no | prospect |
| filterIndustry | no | Healthcare |
| filterCreated | no | month |
| sortBy | no | name |
| sortDir | no | asc |
| lite | no | false |

## Example request

```bash
curl -X GET 'https://dashboard.vinsi.ai/api/crm/companies' \
  -H 'x-api-key: YOUR_API_KEY'
```

## Example response

```json
{
  "items": [
    {
      "id": 318,
      "name": "Acme Dental",
      "industry": "Healthcare",
      "website": "https://acme-dental.example.com",
      "phone": "+15555550100",
      "email": "info@acme-dental.example.com",
      "address": "100 Main St",
      "city": "San Diego",
      "state": "CA",
      "zip": "92101",
      "country": "US",
      "type": "prospect",
      "ownerId": "cmexampleuser0000000000001",
      "createdAt": "2026-09-01T18:30:00.000Z",
      "updatedAt": "2026-09-01T18:30:00.000Z",
      "primaryContactId": 1042,
      "logoUrl": null,
      "customFieldValues": {
        "12": {
          "Number of Locations": "3"
        }
      }
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 25,
  "counts": {
    "my": 1,
    "all": 42,
    "ours": 12,
    "prospects": 30
  }
}
```