---
title: "Get assigned agreements"
method: GET
path: "/platform/v2/customers/{customerId}/agreements"
tags: ["Agreements"]
---

# Get assigned agreements

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

## Request

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

Returns the set of agreements assigned to an existing customer. Each item carries its current `status` (PENDING / ACCEPTED / REJECTED) and, once responded to, the `respondedAt` timestamp. All assigned agreements must reach `ACCEPTED` for onboarding to proceed.

## Path parameters

- `customerId` string, uuid, required

## Response `200`

List of assigned agreements

- V2PaginatedAssignedAgreementResponse
  - `totalElements` integer
  - `totalPages` integer
  - `content` V2AssignedAgreementResponse[]
    - `id` string, uuid
    - `agreement` V2AgreementSummary: Compact agreement descriptor.
      - `version` string: Version of the agreement.
      - `title` string: Human-readable title.
      - `locale` string: Locale tag (e.g. en-GB).
    - `status` 'PENDING' | 'ACCEPTED' | 'REJECTED'
    - `respondedAt` string, date-time
    - `respondedToDocumentChecksum` string: SHA-256 hex checksum of the document the customer responded to.
    - `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-06-16** `97d6c0d2fe2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/platform/v2/customers/:customerId/agreements/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)