> ## Documentation Index
> Fetch the complete documentation index at: https://careerk.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get All Companies

> Retrieve a paginated list of companies with optional filters

## Endpoint

```
GET /api/v1/companies
```

**Base URL**: `http://localhost:3000/api/v1`

<Note>This endpoint is **public** and does not require authentication.</Note>

## Query Parameters

<ParamField query="page" type="number">
  Page number for pagination (default: 1).
</ParamField>

<ParamField query="limit" type="number">
  Number of results per page (default: 20).
</ParamField>

<ParamField query="name" type="string">
  Filter by company name (partial string match, case-insensitive).
</ParamField>

<ParamField query="industry" type="string">
  Filter by industry (partial string match, case-insensitive).
</ParamField>

<ParamField query="size" type="enum">
  Filter by company size. - `SIZE_1_50` - 1-50 employees - `SIZE_51_200` - 51-200 employees -
  `SIZE_201_1000` - 201-1000 employees - `SIZE_1000_PLUS` - 1000+ employees
</ParamField>

<ParamField query="type" type="enum">
  Filter by company type. - `STARTUP` - `SCALE_UP` - `ENTERPRISE` - `NON_PROFIT` - `GOVERNMENT`
</ParamField>

<ParamField query="location" type="string">
  Filter by headquarters location (partial string match, case-insensitive).
</ParamField>

<ParamField query="isVerified" type="boolean">
  Filter by verification status.
</ParamField>

## Response

```json theme={null}
{
  "success": true,
  "data": {
    "companies": [
      {
        "id": "uuid",
        "name": "Tech Corp",
        "description": "A leading technology company",
        "logoUrl": "https://...",
        "industry": "Technology",
        "size": "SIZE_201_1000",
        "type": "ENTERPRISE",
        "headquartersLocation": "Cairo, Egypt",
        "foundedYear": 2015,
        "websiteUrl": "https://techcorp.com",
        "benefits": "Health insurance, remote work",
        "linkedIn": "https://linkedin.com/company/techcorp",
        "facebook": "https://facebook.com/techcorp",
        "twitter": "https://twitter.com/techcorp"
      }
    ],
    "total": 50,
    "page": 1,
    "limit": 20,
    "totalPages": 3
  },
  "message": "Company profiles retrieved successfully",
  "meta": {
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies",
    "method": "GET"
  }
}
```

## Error Responses

### 400 Bad Request - Validation Error

```json theme={null}
{
  "success": false,
  "error": {
    "message": ["page must not be less than 1"],
    "statusCode": 400,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies",
    "method": "GET",
    "details": "Bad Request"
  }
}
```