---
title: "Fetch agreements"
method: GET
path: "/api/v1/agreement"
tags: ["Onboarding"]
---

# Fetch agreements

`GET /api/v1/agreement`

## Request

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

Fetch all required agreement documents needed to onboard a Customer.

:::warning Use with Customers v1
This endpoint is part of the Agreements v1 flow and must be used together with [Customers v1 endpoints](/bvnk/api-explorer/endpoints/create-customer). Customers created via Customers v2 use a different agreements flow.
:::

## Query parameters

- `product` string, required
- `country` string

## Response `200`

Successful operation

- object[]
  - `declinable` boolean: Indicates whether the agreement can be declined.
  - `description` string: Description of the agreement.
  - `id` integer: Unique identifier for the agreement.
  - `name` string: Name of the agreement.
  - `privacyPolicyDescription` string: Description of the privacy policy associated with the agreement.
  - `privacyPolicyName` string: Name of the privacy policy.
  - `privacyPolicyUrl` string, uri: URL to the privacy policy document.
  - `reference` string: Reference identifier for the agreement.
  - `url` string, uri: URL to the agreement document.

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[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)