---
title: "Get Agb Acceptances"
method: GET
path: "/api/user/v1/agb-acceptances"
tags: ["Users"]
---

# Get Agb Acceptances

`GET /api/user/v1/agb-acceptances`

## Request

- The document declares no server URL.
- Auth: OpenID Connect (`http://localhost:6999/realms/agate/.well-known/openid-configuration`, scopes: `agridata.ch.Agridata_Admin`, `agridata.ch.Agridata_Support`)

Returns the AGB acceptance state of all users who accepted the AGB at least once. The search term is matched against the UID (stored without separators, e.g. CHE123456789). Supports the filter 'status' (ACCEPTED, TRANSITION_PERIOD, PENDING), pagination and sorting on 'givenName', 'familyName', 'email', 'uid' and 'lastAcceptedAgbDate' (default: uid,familyName).

## Query parameters

- `filter` object: Column filters in the form '<column>:<value>[,<value>]', multiple filters separated by ';'. Values of the same column are combined with OR, filters on different columns with AND. Duplicate values are ignored. The filterable columns are documented per endpoint.
- `language` string: language code for multilingual fields. Must be supported by application.
- `page` integer: page number
- `searchTerm` string: string to search for in the resource
- `size` integer: page size
- `sortBy` object: List of field names to sort by. Default is ascending prefix with - for descending

## Response `200`

OK

- PageResponseDtoAgbAcceptanceOverviewDto: Generic paginated response wrapper.
  - `items` AgbAcceptanceOverviewDto[], required: List of items on the current page.
    - `userId` string, uuid
    - `givenName` string: User's first name.
    - `familyName` string: User's last name.
    - `email` string: Email address of the user
    - `uid` string: UID of the company the user belongs to.
    - `lastAcceptedAgbDate` string, date-time
    - `lastAcceptedAgbVersion` string: Version of the AGB revision the user last accepted.
    - `status` 'ACCEPTED' | 'TRANSITION_PERIOD' | 'PENDING'
  - `totalItems` integer, required: Total number of items across all pages.
  - `totalPages` integer, required: Total number of pages available.
  - `currentPage` integer, required: Current page number (0-based ).
  - `pageSize` integer, required: Number of items per page.

## Other responses

- `401`: Not Authorized
- `403`: Not Allowed
- `404`: The resource or element was not found
- `500`: Internal server error: unexpected error

## Changes

- **2026-10-29** `85ae7666ead1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agridata/apis/agridata-ch-api/changes/api/user/v1/agb-acceptances/get.md)

---

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