---
title: "List client companies"
method: GET
path: "/partner_api/v1/client_companies"
tags: ["Client companies"]
---

# List client companies

`GET /partner_api/v1/client_companies`

## Request

- Base URL: `https://api.contentsnare.com`
- URL: `https://api.contentsnare.com/partner_api/v1/client_companies`
- Auth: one of:
  - OAuth 2
    - Authorization code: `/oauth/authorization`
    - Token URL: `/oauth/token` scopes: `read_clients`
  - HTTP bearer

Returns list of client companies<br>Required scopes: <b>read_clients</b>

## Query parameters

- `limit` integer
- `offset` integer
- `q` string
- `q_by[]` string[]
- `sort_by` 'name'
- `sort_direction` 'asc' | 'desc'

## Response `200`

successful

- object
  - `pagination` PaginationClientCompanies
    - `limit` integer
    - `offset` integer
    - `q` string
    - `q_by` string[]
    - `sort_by` string
    - `sort_direction` string
    - `total_count` integer
  - `results` ClientCompany[]
    - `id` string
    - `name` string

## Other responses

- `401`: unauthorized
- `403`: forbidden

---

[API](https://skmtc.dev/contentsnare/apis/api-general-info.md) - [All operations](https://skmtc.dev/contentsnare/apis/api-general-info/llms.txt) - [OpenAPI document](https://skmtc.dev/contentsnare/apis/api-general-info/revisions/d3048549a0ba?raw)