---
title: "List company associations"
method: GET
path: "/appReseller/v1/companyAssociations"
tags: ["AppResellerCompanyAssociation"]
---

# List company associations

`GET /appReseller/v1/companyAssociations`

## Request

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

Retrieves all customer company associations. This request requires either the Reseller company ID or the Customer company ID, which you can retrieve with the [List companies](#list-companies) request.

## Query parameters

- `resellerCompanyId` string, required
- `customerCompanyId` string, required
- `searchText` string
- `createdOn` string
- `sort` string
- `number` integer
- `size` integer

## Response `200`

Success

- CustomerCompanyAssociationPagedReadResponse
  - `page` PageMetadata, required
    - `number` number, required: Page number
    - `size` number, required: Size of the page to be returned
    - `totalElements` number, required: Total number of elements
    - `totalPages` number, required: Total number of pages
  - `content` CustomerCompanyAssociation[], required
    - `id` string, required: Customer company ID
    - `resellerCompany` CompanyAssociation, required: A minimum version of a company: includes only the company ID and name
      - `id` string, required: Company ID
      - `name` string, required: Company name
    - `customerCompany` CompanyAssociation, required: A minimum version of a company: includes only the company ID and name
      - `id` string, required: Company ID
      - `name` string, required: Company name
    - `createdOn` number, required: Date on which new customer company association was created, in UNIX Epoch milliseconds

## Changes

- **2026-11-06** `1fc240f06971`: 1 breaking, 2 info
  - the response's body type changed from no type to `object` for status `200`
  - added the required property `content` to the response with the `200` status
  - added the required property `page` to the response with the `200` status

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/appReseller/v1/companyAssociations/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)
