# companies (/api/reference/queries/companies)

The workspace's companies: clients, leads and candidates' employers alike, unless `filter` narrows them.

```graphql
companies(
  after: String
  before: String
  filter: CompanyFilter
  first: Int
  last: Int
  orderBy: CompanyOrder
): CompanyConnection!
```

### Arguments [#arguments]

#### [`companies.after`](#after) · [`String`](/api/reference/scalars/string) `scalar` [#after]
Return the rows that follow this cursor.

#### [`companies.before`](#before) · [`String`](/api/reference/scalars/string) `scalar` [#before]
Return the rows that come before this cursor.

#### [`companies.filter`](#filter) · [`CompanyFilter`](/api/reference/inputs/company-filter) `input` [#filter]
Narrow the list. Left out, every company is returned, archived ones and plain employers included.

#### [`companies.first`](#first) · [`Int`](/api/reference/scalars/int) `scalar` [#first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

#### [`companies.last`](#last) · [`Int`](/api/reference/scalars/int) `scalar` [#last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`companies.orderBy`](#order-by) · [`CompanyOrder`](/api/reference/enums/company-order) `enum` [#order-by]
The order of the list. `ID` when left out.

### Type [#type]

#### [`CompanyConnection`](/api/reference/objects/company-connection) `object` [#companyconnection-object]
A page of companies.