---
title: "Get Companies"
method: GET
path: "/api/v2/companies/"
tags: ["Companies"]
---

# Get Companies

`GET /api/v2/companies/`

This endpoint returns filtered & sorted companies.

AUTHENTICATION (dual-mode):
- Global admin (Clerk or legacy) → all companies.
- Clerk non-admin → companies whose Clerk org the user belongs to (Redis).
- Legacy non-admin → companies from permission_id=3 entries in DB.

## Query parameters

- `projection` string[], nullable — Fields to return.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/curatedforyou/apis/curated-for-you-api.md) · [All operations](https://skmtc.net/curatedforyou/apis/curated-for-you-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/curatedforyou/curated-for-you-api/revisions/7cbc2a21dd49/schema)