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

# Get Contract Revision

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

Retrieves a specific contract revision by its ID. Accessible by the consumer or provider that owns the associated datarequest.

## Path parameters

- `id` string, uuid, required

## Query parameters

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

## Response `200`

OK

- ContractRevisionDto
  - `id` string, uuid, required
  - `dataRequestId` string, uuid, required
  - `dataConsumerName` string, required — LegalName of the data consumer taken from the uid register
  - `dataConsumerCity` string, required — City of the data consumer
  - `dataProviderName` string, required — Name of the data provider
  - `dataProviderCity` string, required — City of the data provider
  - `dataRequestContext` DataRequestContextDto, required — Data transfer object representing a minimal version of a data request for UI/UX use.
    - `dataConsumerLogoBase64` string — Base64-encoded logo of the data consumer
  - `consumerSignatures` ContractRevisionSignatureDto[] — List of signatures of the data consumer
    - `signatureSlotCode` 'DATA_CONSUMER_01' | 'DATA_CONSUMER_02' | 'DATA_PROVIDER_01' | 'DATA_PROVIDER_02', required
    - `userId` string, uuid, required
    - `name` string, required — Name of the user of the signature
    - `timestamp` string, date-time, required
  - `providerSignatures` ContractRevisionSignatureDto[] — List of signatures of the data provider
    - `signatureSlotCode` 'DATA_CONSUMER_01' | 'DATA_CONSUMER_02' | 'DATA_PROVIDER_01' | 'DATA_PROVIDER_02', required
    - `userId` string, uuid, required
    - `name` string, required — Name of the user of the signature
    - `timestamp` string, date-time, required
  - `consumerSignatureType` 'INDIVIDUAL_SIGNATURE' | 'COLLECTIVE_SIGNATURE'
  - `providerSignatureType` 'INDIVIDUAL_SIGNATURE' | 'COLLECTIVE_SIGNATURE'
  - `sealState` 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED'

## 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-25** `dc5441e12c1b` — 1 info
  - added the optional property `sealState` to the response with the `200` status
- **2026-06-04** `d1729646b766` — 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-05-29** `a598446f8093` — 2 info
  - removed the `DATA_PROVIDER_ERROR` enum value from the `type` response property for the response status `404`
  - removed the `DATA_PROVIDER_ERROR` enum value from the `type` response property for the response status `500`
- **2026-05-26** `7cee7b14bf6f` — 2 warning, 1 info
  - 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`
  - 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

[Full history](https://skmtc.dev/agridata/apis/agridata-ch-api/changes/api/agreement/v1/contract-revisions/:id/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-service-production.skmtc.workers.dev/v1/apis/agridata/agridata-ch-api/revisions/cb85ba8b5d77/schema)