---
title: "Read segment companies"
method: GET
path: "/channel/v1/segments/{companySegmentId}/availableAndAssociatedCompanies"
tags: ["SegmentFolders"]
---

# Read segment companies

`GET /channel/v1/segments/{companySegmentId}/availableAndAssociatedCompanies`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/channel/v1/segments/{companySegmentId}/availableAndAssociatedCompanies`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/channel/v1/segments/:companySegmentId/availableAndAssociatedCompanies/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of all marketplace companies and indicates whether they are associated with the segment

## Path parameters

- `companySegmentId` string, required

## Query parameters

- `number` integer
- `size` integer
- `sort` string
- `searchText` string
- `selected` boolean

## Response `200`

Success

- PagedAvailableCompanySegmentAssociation: Paged information about all marketplace companies, including whether they are associated with the segment
  - `content` AvailableCompanySegmentAssociation[]: Information about all marketplace companies, including whether they are associated with the segment
    - `name` string, required: The company name
    - `id` string, required: The company ID
    - `selected` boolean, required: Indicates whether this company is associated with the segment
  - `page` PageMeta
    - `number` number: Page number
    - `size` number: Number of results to return
    - `totalElements` number: Total number of elements
    - `totalPages` number: Total number of pages

## Other responses

- `400`: Bad request

## Changes

- **2026-11-06** `1fc240f06971`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/channel/v1/segments/:companySegmentId/availableAndAssociatedCompanies/get.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)