---
title: "Get Contract Revision Pdf"
method: GET
path: "/api/agreement/v1/contract-revisions/{id}/pdf"
tags: ["Contract Revisions"]
---

# Get Contract Revision Pdf

`GET /api/agreement/v1/contract-revisions/{id}/pdf`

## 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_Datenanbieter`, `agridata.ch.Agridata_Datenbezueger`)

Returns the pdf of the contract revision

## Path parameters

- `id` string, uuid, required

## Query parameters

- `actingRole` 'CONSUMER' | 'PROVIDER' | 'ADMIN'

## Response `200`

OK

## Other responses

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

## Changes

- **2026-06-02** `7cee7b14bf6f`: 2 warning
  - added the new `DATA_PROVIDER_ERROR` enum value to the `type` response property for the response status `404`
  - added the new `DATA_PROVIDER_ERROR` enum value to the `type` response property for the response status `500`
- **2026-06-02** `a598446f8093`: 1 info
  - added the new optional `query` request parameter `actingRole`
- **2026-05-12** `5b038eea902d`: 8 warning
  - added the new `OTP_EXPIRED` enum value to the `type` response property for the response status `404`
  - added the new `OTP_EXPIRED` enum value to the `type` response property for the response status `500`
  - added the new `OTP_INVALID` enum value to the `type` response property for the response status `404`
  - added the new `OTP_INVALID` enum value to the `type` response property for the response status `500`
  - …4 more
- **2026-05-04** `b2698fe1c30a`: 2 info
  - the security scope `agridata.ch.Agridata_Admin` was added to the endpoint's security scheme `SecurityScheme`
  - the security scope `agridata.ch.Agridata_Datenanbieter` was added to the endpoint's security scheme `SecurityScheme`
- **2026-04-20** `198c29041a3a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agridata/apis/agridata-ch-api/changes/api/agreement/v1/contract-revisions/:id/pdf/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/bf09fcfe746c?raw)
