---
title: "Set Data Request Status"
method: PUT
path: "/api/agreement/v1/data-requests/{id}/status"
tags: ["Data Requests"]
---

# Set Data Request Status

`PUT /api/agreement/v1/data-requests/{id}/status`

sets status of data request. Only accessible to the consumer who owns the data request and to admins. Only specific transitions are allowed.

## Path parameters

- `id` string, uuid, required

## Query parameters

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

## Request body

- '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'

## Response `200`

OK

- DataRequestDto — Details of the underlying 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

---

[API](https://skmtc.net/agridata/apis/agridata-ch-api.md) · [All operations](https://skmtc.net/agridata/apis/agridata-ch-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agridata/agridata-ch-api/versions/4f3c6bfcfcfd/schema)