---
title: "List companies"
method: GET
path: "/v1/locations/{locationId}/companies"
tags: ["Companies"]
---

# List companies

`GET /v1/locations/{locationId}/companies`

## Request

- Base URL: `https://api.cliento.com`
- URL: `https://api.cliento.com/v1/locations/{locationId}/companies`
- Auth: HTTP bearer

The location's companies, oldest first, one page at a time. To find one, filter on its organisation number or your own reference.

## Path parameters

- `locationId` string, required

## Query parameters

- `organisationNumber` string
- `externalReference` string
- `limit` integer
- `after` string

## Response `200`

OK

- CompanyList
  - `data` Company[], required
    - `address` Address
      - `city` string, nullable
      - `country` string, nullable: Free text; an ISO 3166-1 alpha-2 code is recommended.
      - `line1` string, nullable
      - `line2` string, nullable
      - `line3` string, nullable
      - `postCode` string, nullable
    - `createdAt` string, date-time
    - `department` string: A part of the company, when the location serves several of them.
    - `email` string
    - `externalReference` string: Your own id for it, as sent when it was created.
    - `id` string, required
    - `locationId` string, required
    - `name` string
    - `notes` string: Staff-facing notes, at most 1000 characters.
    - `organisationNumber` string: The Swedish organisation number: ten digits with a valid check digit, with no hyphen.
    - `otherPhoneNumber` string
    - `phoneNumber` string: Phone number, in E.164 format when it was set through this API.
    - `updatedAt` string, date-time
  - `nextCursor` string: Pass as `after` to fetch the next page. Absent on the last page.

## Other responses

- `default`: Any failure. See the Errors section.

---

[API](https://skmtc.dev/cliento/apis/cliento-api.md) · [All operations](https://skmtc.dev/cliento/apis/cliento-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cliento/apis/cliento-api/revisions/29ca811bc061?raw)