---
title: "Retrieve assigned agreements"
method: GET
path: "/onboarding/v1/assigned-agreements"
tags: ["Onboarding"]
---

# Retrieve assigned agreements

`GET /onboarding/v1/assigned-agreements`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/onboarding/v1/assigned-agreements`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/onboarding/v1/assigned-agreements/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns agreements assigned to an onboarding application. All assigned agreements must reach `ACCEPTED` status for onboarding to proceed.

Use this endpoint with the onboarding application ID: `GET /onboarding/v1/assigned-agreements?applicationId={onboardingId}`.

Assigned agreements can be accepted at any point after customer creation (before or after document uploads); there is no ordering dependency.

## Query parameters

- `applicationId` string, uuid, required

## Response `200`

Assigned agreements for the onboarding application

- OnboardingAssignedAgreement[]
  - `id` string, uuid, required
  - `applicationId` string, uuid, required
  - `agreement` OnboardingAgreementDetails, required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, required
    - `urn` string, required
    - `agreementType` 'EXTERNAL_LINK', required
    - `externalUrl` string, uri
    - `declinable` boolean, required
  - `status` 'PENDING' | 'ACCEPTED' | 'DECLINED', required
  - `createdAt` string, date-time, required

## Other responses

- `401`: Unauthorized

## Changes

- **2026-06-16** `97d6c0d2fe2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/onboarding/v1/assigned-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)