---
title: "List all Companies of the Organization"
method: GET
path: "/2024-11/organizations/{organization_id}/companies"
tags: ["Organizations"]
---

# List all Companies of the Organization

`GET /2024-11/organizations/{organization_id}/companies`

## Request

- Base URL: `https://enterprise-api.easyship.com`
- URL: `https://enterprise-api.easyship.com/2024-11/organizations/{organization_id}/companies`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://enterprise-api.easyship.com/oauth2/token` scopes: `enterprise.company`

Retrieve a list of companies from a specific organization.

Required authorization scope: `enterprise.company:read`

## Path parameters

- `organization_id` string, uuid, required

## Query parameters

- `sort_by` 'company_name' | 'created_at'
- `sort_direction` 'ASC' | 'DESC'
- `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.dev/easyship/apis/easyship-enterprise-api.md) - [All operations](https://skmtc.dev/easyship/apis/easyship-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/easyship/apis/easyship-enterprise-api/revisions/e22015413521?raw)