---
title: "Data Transfer"
method: GET
path: "/api/data-transfer/v1/data"
tags: ["Data Transfer"]
---

# Data Transfer

`GET /api/data-transfer/v1/data`

Retrieves data defined by productId of organisation identified bi uid or bur local unit.

## Query parameters

- `bur` string
- `productId` string, uuid, required
- `surveyYear` integer, required
- `uid` string

## Response `200`

OK

- AgisStructureResponseType
  - `cantonFlAbbreviation` 'ZH' | 'BE' | 'LU' | 'UR' | 'SZ' | 'OW' | 'NW' | 'GL' | 'ZG' | 'FR' | 'SO' | 'BS' | 'BL' | 'SH' | 'AR' | 'AI' | 'SG' | 'GR' | 'AG' | 'TG' | 'TI' | 'VD' | 'VS' | 'NE' | 'GE' | 'JU' | 'FL', required
  - `surveyYear` integer, required
  - `dataRequestType` AgisDataRequestTypeType, required
    - `aggregatedResults` boolean
    - `finalData` boolean
  - `structuralData` AgisStructuralDataType[], required
    - `ktIdB` string, required
    - `ber` string
    - `ktIdP` string, required
    - `uid` string
    - `farmPersonDetails` AgisFarmPersonDetailsType, required
      - `farmDetails` AgisFarmDetailsType, required
        - `farmType` string, required
        - `localMunicipality` AgisMunicipalityType
          - `municipalityName` string
          - `municipalityId` integer
          - `cantonFlAbbreviation` 'ZH' | 'BE' | 'LU' | 'UR' | 'SZ' | 'OW' | 'NW' | 'GL' | 'ZG' | 'FR' | 'SO' | 'BS' | 'BL' | 'SH' | 'AR' | 'AI' | 'SG' | 'GR' | 'AG' | 'TG' | 'TI' | 'VD' | 'VS' | 'NE' | 'GE' | 'JU' | 'FL'
        - `coordinatesEast` integer
        - `coordinatesNorth` integer
        - `altitude` integer
        - `agriculturalZone` string
        - `agriculturalArea` string
        - `EGID` integer
        - `EGAID` integer
      - `personDetails` AgisPersonDetailsType, required
        - `legalForm` string, required
        - `dateOfBirth` string, date
        - `foundationYear` integer
        - `languageOfCorrespondance` string
        - `postalAddress` AgisPersonMailAddressType
          - `person` AgisPersonMailAddressInfoType
            - `firstName` string
            - `lastName` string
          - `addressInformation` AgisAddressInformationType
            - `addressLine1` string
            - `addressLine3` string
            - `street` string
            - `houseNumber` string
            - `town` string
            - `swissZipCode` integer
            - `foreignZipCode` string
        - `residenceMunicipality` AgisMunicipalityType
          - `municipalityName` string
          - `municipalityId` integer
          - `cantonFlAbbreviation` 'ZH' | 'BE' | 'LU' | 'UR' | 'SZ' | 'OW' | 'NW' | 'GL' | 'ZG' | 'FR' | 'SO' | 'BS' | 'BL' | 'SH' | 'AR' | 'AI' | 'SG' | 'GR' | 'AG' | 'TG' | 'TI' | 'VD' | 'VS' | 'NE' | 'GE' | 'JU' | 'FL'
        - `EGAID` integer
      - `farmCharacteristics` AgisFarmCharacteristicsType, required
        - `ZATypology` string, required
        - `surface` integer, required
        - `livestockUnit` number, required
        - `structure` boolean, required
        - `summeringStructure` boolean, required
        - `surveyNorm` boolean, required
        - `bioContribution` boolean, required
        - `achieveOeln` boolean, required
        - `directPayment` boolean, required
        - `individualCultureContribution` boolean, required
        - `summeringContribution` boolean, required
        - `insituContribution` boolean, required
        - `cerealsContribution` boolean, required
        - `validSince` string, date-time, required
    - `structuralDataRoot` AgisStructuralDataRootType
      - `generalData` AgisGeneralDataType
        - `farmGeneralData` AgisFarmGeneralData[]
          - `creationDate` string, date
          - `code` string, required
          - `quantity` integer, required
        - `farmGeneralDataDeclaration` AgisFarmGeneralDataDeclaration[]
          - `creationDate` string, date
          - `code` string, required
          - `relevant` boolean
      - `animalData` AgisAnimalDataType
        - `animalStock` AgisAnimalStock[], required
          - `creationDate` string, date
          - `surveyKtIdB` string, required
          - `ber` string
          - `animalCategory` string, required
          - `atdData` AgisAtdDataType
            - `atdDataFinal` AgisAtdDataFinalType, required
              - …
          - `selfreportedData` AgisSelfReportedDataType[]
            - `declarationDayQuantity` integer
            - `averageQuantity` integer
            - `keepingType` string
            - `summeringQuantity` integer
            - `summeringDuration` integer
          - `BTSRAUS` integer
      - `animalSummeringData` AgisAnimalSummeringDataType
        - `animalStock` AgisAnimalSummeringStock[], required
          - `creationDate` string, date
          - `animalCategory` string, required
          - `atdData` AgisAtdSummeringDataType
            - `atdDataFinal` AgisAtdSummeringDataFinalType, required
              - …
          - `selfreportedData` AgisSelfReportedSummeringDataType[]
            - `quantity` integer
            - `summeringDuration` integer
      - `generalSurfaceData` AgisGeneralSurfaceDataType
        - `surface` AgisSurface[], required
          - `creationDate` string, date
          - `surveyKtIdB` string, required
          - `ber` string
          - `surfaceId` string
          - `cultureId` string
          - `locality` string
          - `municipalityId` integer
          - `agriculturalZone` string
          - `cultivationType` string, required
          - `cultivationTypeAttribute` string
          - `areaGross` integer
          - `areaNet` integer, required
          - `cultivated` boolean
          - `natureProtectionSurface` boolean
          - `psSoilMildTreatment` boolean
          - `psmArableFarming` boolean
          - `psmVegetablesBerries` boolean
          - `psmPerennialCulture` boolean
          - `psmBioAids` boolean
          - `psmHerbicide` boolean
          - `bio` boolean
          - `culturalLandscapeContribution` boolean
          - `individualCultureContribution` boolean
      - `slopeSurfaceData` AgisSlopeSurfaceDataType
        - `slopeSurface` AgisSlopeSurface[], required
          - `creationDate` string, date
          - `surveyKtIdB` string, required
          - `ber` string
          - `surfaceId` string
          - `cultureId` string
          - `locality` string
          - `municipalityId` integer
          - `agriculturalZone` string
          - `cultivationType` string, required
          - `slope18To35Area` integer
          - `slope35To50Area` integer
          - `slope50PlusArea` integer
          - `cultivated` boolean
          - `contributionAuthorization` boolean
      - `grapeSurfaceData` AgisGrapeSurfaceDataType
        - `grapeSurface` AgisGrapeSurface[], required
          - `creationDate` string, date
          - `surveyKtIdB` string, required
          - `ber` string
          - `surfaceId` string
          - `cultureId` string
          - `locality` string
          - `municipalityId` integer
          - `agriculturalZone` string
          - `cultivationType` string, required
          - `slopeGrape30To50Area` integer
          - `slopeGrape50PlusArea` integer
          - `slopeGrapeTerrace` integer
          - `bioContribution` boolean
          - `contributionAuthorization` boolean
      - `biodiversitySurfaceData` AgisBiodiversitySurfaceDataType
        - `biodiversitySurface` AgisBiodiversitySurface[], required
          - `creationDate` string, date
          - `surveyKtIdB` string, required
          - `ber` string
          - `surfaceId` string
          - `cultureId` string
          - `locality` string
          - `municipalityId` integer
          - `agriculturalZone` string
          - `cultivationType` string, required
          - `cultivationTypeAttribute` string
          - `areaGross` integer
          - `areaNet` integer, required
          - `biodiversityCategory` string
          - `biodiversityCommitmentStart` integer
          - `natureProtectionSurface` boolean
          - `natureProtectionCommitmentStart` integer
          - `cultivated` boolean
          - `contributionAuthorization` boolean
      - `networkSurfaceData` AgisNetworkSurfaceDataType
        - `networkSurface` AgisNetworkSurface[], required
          - `creationDate` string, date
          - `surveyKtIdB` string, required
          - `ber` string
          - `surfaceId` string
          - `cultureId` string
          - `locality` string
          - `municipalityId` integer
          - `agriculturalZone` string
          - `cultivationType` string, required
          - `cultivationTypeAttribute` string
          - `areaGross` integer
          - `areaNet` integer, required
          - `networkCommitmentStart` integer
          - `networkContribution` AgisNetworkContribution[]
            - `organization` string, required
            - `organizationName` string
            - `federalAmountUsed` boolean
            - `contributionAmount` number
          - `contributionAuthorization` boolean
      - `countrysideQualityData` AgisCountrysideQualityDataType
        - `countrysideQualityProject` AgisCountrysideQualityProject[], required
          - `creationDate` string, date
          - `surveyKtIdB` string, required
          - `ber` string
          - `surfaceId` string
          - `locality` string
          - `municipalityId` integer
          - `projectName` string, required
          - `projectElements` AgisProjectElementsType[], required
            - `measureId` string, required
            - `category` string
            - `quantity` number, required
            - `contributionAmount` number, required
            - `contributionAuthorization` boolean
      - `aquacultureData` AgisAquacultureDataType
        - `aquaticAnimalData` AgisAquaticAnimalData[], required
          - `creationDate` string, date
          - `surveyKtIdB` string, required
          - `ber` string
          - `aquaticAnimalTypes` AgisAquaticAnimalTypes
            - `aquaticAnimalPerCategory` AgisAquaticAnimalPerCategory[], required
              - …
          - `breedingTypes` AgisBreedingTypes
            - `breedingType` string[], required
          - `productionForms` AgisProductionForms
            - `productionForm` string[], required
          - `waterSupplyTypes` AgisWaterSupplyTypes
            - `waterSupplyType` string[], required
          - `waterDrainTypes` AgisWaterDrainTypes
            - `waterDrainType` string[], required
      - `apicultureData` AgisApicultureDataType
        - `farmApicultureData` AgisFarmApicultureData[], required
          - `creationDate` string, date
          - `surveyKtIdB` string, required
          - `ber` string
          - `colonyCount` integer, required

## 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.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/2c9aad2e6e1c/schema)