---
title: "POST /api/v2/agreements/enduser/"
method: POST
path: "/api/v2/agreements/enduser/"
tags: ["agreements"]
---

# POST /api/v2/agreements/enduser/

`POST /api/v2/agreements/enduser/`

## Request

- Base URL: `https://bankaccountdata.gocardless.com`
- URL: `https://bankaccountdata.gocardless.com/api/v2/agreements/enduser/`
- Auth: HTTP bearer

API endpoints related to end-user agreements.

## Request body

- EndUserAgreementRequest: Represents an end-user agreement.
  - `institution_id` string, required: an Institution ID for this EUA
  - `max_historical_days` integer: Maximum number of days of transaction data to retrieve.
  - `access_valid_for_days` integer: Number of days from acceptance that the access can be used.
  - `access_scope` unknown[]: Array containing one or several values of ['balances', 'details', 'transactions']
    - unknown
  - `reconfirmation` boolean: if this agreement can be extended. Supported by GB banks only.

## Response `201`

Create enduser agreement

- EndUserAgreement: Represents an end-user agreement.
  - `id` string, uuid: The ID of this End User Agreement, used to refer to this end user agreement in other API calls.
  - `created` string, date-time: The date & time at which the end user agreement was created.
  - `institution_id` string, required: an Institution ID for this EUA
  - `max_historical_days` integer: Maximum number of days of transaction data to retrieve.
  - `access_valid_for_days` integer: Number of days from acceptance that the access can be used.
  - `access_scope` unknown[]: Array containing one or several values of ['balances', 'details', 'transactions']
    - unknown
  - `accepted` string, date-time, nullable: The date & time at which the end user accepted the agreement.
  - `reconfirmation` boolean: if this agreement can be extended. Supported by GB banks only.

## Other responses

- `400`: Reconfirmation is not allowed
- `401`: Token is invalid or expired
- `402`: Free usage limit exceeded
- `403`: Reconfirmation is not enabled for this company.
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/gocardless/apis/gocardless-bank-account-data-api.md) - [All operations](https://skmtc.dev/gocardless/apis/gocardless-bank-account-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gocardless/apis/gocardless-bank-account-data-api/revisions/01fd14b88051?raw)