---
title: "Get List of Companies"
method: GET
path: "/companies"
tags: ["Companies"]
---

# Get List of Companies

`GET /companies`

Retrieve a list of companies configured in your SysAid account.

## Query parameters

- `limit` integer
- `offset` integer
- `query` string
- `name` string
- `id` integer[]
- `state` string
- `city` string
- `country` string
- `address` string
- `agreementId` integer[]
- `sortBy` 'id' | 'name' | 'address' | 'address2' | 'city' | 'state' | 'country' | 'zip' | 'phone' | 'fax' | 'emailAccount' | 'agreementId' | 'expirationDate' | 'agreementStartDate' | 'agreementEndDate'
- `sortDir` 'asc' | 'desc'

## Response `200`

Returns a list of companies.

- GetCompaniesResponse
  - `limit` integer — The number of items that are returned per page
  - `offset` integer — The offset used for pagination.
  - `total` integer — The total number of elements across all pages.
  - `data` Company[]
    - `name` string, nullable — Name of the company.
    - `address` string, nullable — Main company address.
    - `address2` string, nullable — Additional company address.
    - `city` string, nullable — The city in which the company is located.
    - `state` string, nullable — The state in which the company is located.
    - `zip` string, nullable — The company's zip code.
    - `country` string, nullable — The country in which the company is located.
    - `phone` string, nullable — The company’s phone number.
    - `fax` string, nullable — The company’s fax number.
    - `notes` string, nullable — Notes related to the company.
    - `emailAccount` string, nullable — Default email account.
    - `expirationDate` string, date, nullable — The date when the company's access to the help will expire.
    - `agreementId` integer, nullable — The ID of the SLA applied to the company.
    - `agreementStartDate` string, date, nullable — The start date of your service agreement with the company.
    - `agreementEndDate` string, date, nullable — The end date of your service agreement with the company.
    - `customFields` object — Company custom fields.
    - `version` integer, required — The latest retrievable version of the company and its details.
    - `id` integer, required — The unique identifier of the company in SysAid.

## Other responses

- `401` — Authentication information is missing or invalid

---

[API](https://skmtc.net/sysaid/apis/sysaid-public-api.md) · [All operations](https://skmtc.net/sysaid/apis/sysaid-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sysaid/sysaid-public-api/versions/38a43a1b2981/schema)