---
title: "List all Companies"
method: GET
path: "/2024-11/companies"
tags: ["Companies"]
---

# List all Companies

`GET /2024-11/companies`

List all companies which belong to organisation.

Required authorization scope: `enterprise.company:read`

## Query parameters

- `sort_by` 'company_name' | 'created_at'
- `sort_direction` 'ASC' | 'DESC'
- `organization_id` string, uuid
- `company_name` string
- `easyship_company_id` string
- `owner_email` string

## Response `200`

company list

- CompanyList — List of Companies
  - `companies` Company[]
    - `name` string — Company name
    - `country_alpha2` 'AE' | 'AL' | 'AT' | 'AU' | 'BA' | 'BE' | 'BG' | 'CA' | 'CH' | 'CN' | 'CY' | 'CZ' | 'DE' | 'DK' | 'EE' | 'ES' | 'FI' | 'FR' | 'GB' | 'GR' | 'HK' | 'HR' | 'HU' | 'ID' | 'IE' | 'IL' | 'IN' | 'IS' | 'IT' | 'JP' | 'KR' | 'LT' | 'LU' | 'LV' | 'MT' | 'MX' | 'MY' | 'NL' | 'NO' | 'NZ' | 'PH' | 'PL' | 'PT' | 'RO' | 'RS' | 'SE' | 'SG' | 'SI' | 'SK' | 'TH' | 'TR' | 'TW' | 'UA' | 'US' | 'VN' — Country Code in Alpha-2 format (ISO 3166-1)
    - `easyship_company_id` string — Easyship Company ID
    - `external_id` string, nullable — An ID to distinguish different child company under same organization
    - `created_at` string, date-time — Date and time when the company was created
    - `updated_at` string, date-time — Date and time when the company was last updated
    - `owner` CompanyOwner — Company Owner
      - `email` string, (?i-mx:\A(?:[a-z0-9!#$%&'*+\/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+\/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])\z) — Email address
      - `first_name` string — First name of the company owner
      - `last_name` string — Last name of the company owner
      - `mobile_phone` string, nullable — Optional phone number of the company owner.
    - `organization` Organization
      - `id` string, uuid — Organization ID
      - `name` string — Organization name
      - `updated_at` string, datetime
      - `created_at` string, datetime
  - `meta` MetaWithPagination
    - `pagination` Pagination — Pagination
      - `next` integer, nullable
      - `count` integer, nullable — The total number of items. The `null` value is used with countless pagination (used for faster response on large datasets, like shipments).
      - `page` integer — Current page
    - `request_id` string — An unique ID represent the request.

---

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