---
title: "Get Data Request"
method: GET
path: "/api/agreement/v1/data-requests/{id}"
tags: ["Data Requests"]
---

# Get Data Request

`GET /api/agreement/v1/data-requests/{id}`

Retrieves a specific data request by its ID. Accessible to admin users or the consumer who owns the data request.

## Path parameters

- `id` string, uuid, required

## Query parameters

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

## Response `200`

OK

- DataRequestDto — Data transfer object representing a data request
  - `id` string, uuid, required
  - `dataProviderId` string, uuid
  - `dataSourceSystemId` string, uuid
  - `dataSourceSystem` DataSourceSystemReferenceDto
    - `id` string, uuid
    - `code` string — Stable technical code of the source
    - `name` TranslationDto
      - `de` string
      - `fr` string
      - `it` string
    - `dataProvider` DataProviderReferenceDto, required
      - `id` string, uuid
      - `code` string — Stable technical code of the provider
      - `name` TranslationDto
        - `de` string
        - `fr` string
        - `it` string
      - `uid` string — UID of the data provider
  - `humanFriendlyId` string — Human friendly id of the data request
  - `submissionDate` string, date — Date and time when the data request was submitted
  - `title` DataRequestTitleDto
    - `de` string
    - `fr` string
    - `it` string
  - `description` DataRequestDescriptionDto
    - `de` string — Description of the data request
    - `fr` string — Description de la demande de données
    - `it` string — Descrizione della richiesta di dati
  - `purpose` DataRequestPurposeDto
    - `de` string
    - `fr` string
    - `it` string
  - `products` string[] — List of data products requested
  - `stateCode` union, required — State of the data request
    - 'DRAFT' | 'IN_REVIEW' | 'TO_BE_SIGNED_BY_CONSUMER' | 'TO_BE_RELEASED_BY_CONSUMER' | 'TO_BE_SIGNED_BY_PROVIDER' | 'TO_BE_RELEASED_BY_PROVIDER' | 'TO_BE_ACTIVATED' | 'ACTIVE'
    - object
  - `dataConsumerLegalName` string — LegalName of the data consumer taken from the uid register
  - `dataConsumerDisplayName` string — Shorter name of the data consumer defined by the data consumer used when displaying the request to the producer
  - `dataConsumerUid` string — Uid of the data consumer
  - `dataConsumerCity` string — City of the data consumer
  - `dataConsumerZip` string — Zip code of the data consumer
  - `dataConsumerStreet` string — Street of the data consumer
  - `dataConsumerCountry` string — 2 letter country code of the data consumer
  - `contactPhoneNumber` string — Contact phone number for the data request
  - `contactEmailAddress` string — Contact email address for the data request
  - `dataConsumerLogoBase64` string — Base64-encoded logo of the data consumer
  - `targetGroup` string
  - `validRedirectUriRegex` string — Regex of valid redirect_uri. Must compile as regex successfully.
  - `currentContractRevisionId` string, uuid
  - `consumerSignatureType` 'INDIVIDUAL_SIGNATURE' | 'COLLECTIVE_SIGNATURE'
  - `providerSignatureType` 'INDIVIDUAL_SIGNATURE' | 'COLLECTIVE_SIGNATURE'
  - `advantages` DataRequestAdvantageDto[], required — A list of advantages to the producer for sharing their data
    - `de` string
    - `fr` string
    - `it` string

## 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-19** `a3a589189892` — 1 info
  - added the required property `advantages` 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/data-requests/: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/5760204210ed/schema)