---
title: "List customer associates"
method: GET
path: "/platform/v2/customers/{customerId}/associates"
tags: ["Customers"]
---

# List customer associates

`GET /platform/v2/customers/{customerId}/associates`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/platform/v2/customers/{customerId}/associates`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/platform/v2/customers/:customerId/associates/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of associates for a customer.

## Path parameters

- `customerId` string, uuid, required

## Query parameters

- `pageNumber` integer
- `pageSize` integer

## Response `200`

Paginated list of associates

- V2PaginatedAssociateSummaryResponse
  - `totalElements` integer
  - `totalPages` integer
  - `content` V2AssociateSummaryResponse[]
    - `id` string, uuid
    - `types` string[]
    - `displayName` string
    - `validation` V2ValidationStatus
      - `status` 'COMPLETE' | 'INCOMPLETE'
      - `issues` V2ValidationIssue[]
        - `field` string
        - `message` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `pageable` V2Pageable
    - `pageNumber` integer
    - `pageSize` integer
  - `hasNext` boolean

## Other responses

- `401`: Unauthorized
- `404`: The specified resource was not found

## Changes

- **2026-11-06** `c386d436bf2c`: 1 info
  - added the non-success response with the status `404`
- **2026-06-16** `97d6c0d2fe2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/platform/v2/customers/:customerId/associates/get.md)

---

[API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [All operations](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/revisions/c386d436bf2c?raw)