Skip to main content

Major update to Fishhealth API (2025-02-14)

Nóra Zsemlye
Nóra Zsemlye
BarentsWatch forvaltningsteam

To accomodate for changes in the disease data sent by aquaculture sites, the Fishhealth API has some updates.

In addition to Pancreas disease (PD) and Infectious salmon anemia (ISA), the API is now providing data about several other types of disease via new endpoints.

The outdated endpoints have now been marked as obsolete in the Fishhealth API, and will be removed after 25th of May 2025.

Affected endpoints​

  • POST /v2/geodata/fishhealth/{year}/{week}

    Replaces GET /v1/geodata/fishhealth/{year}/{week}

    • year, week, totalNumberOfLocalities, numberOfFilteredLocalities and numberOfReportingLocalities - no longer available
    • diseaseOutbreaks - replaces newLocalitiesWithDisease
    • diseaseStatistics - replaces numberOfLocalitiesWithIla and numberOfLocalitiesWithPd
    • annualDiseaseStatistics - replaces newLocalitiesWithDiseaseAnnual
      • diseaseStatistics - replaces totalNewIlaCases and totalNewPdCases
      • filteredDiseaseStatistics - replaces includedNewIlaCases and includedNewPdCases
      • weeklyDiseaseStatistics - replaces newDiseaseCases
    • farmedFishEscapes - replaces escapes
    • annualEscapeStatistics - replaces escapesAnnual
      • escapeStatistics and filteredEscapeStatistics - new properties
      • weeklyEscapeStatistics - replaces escapes
    • liceStatistics
      • aboveThreshold - replaces localitiesAboveThreshold and percentageOfLocalitiesAboveThreshold
      • belowThreshold - replaces localitiesBelowThreshold and percentageOfLocalitiesBelowThreshold
      • belowMinimumThreshold - replaces localitiesBelowMinimumThreshold and percentageOfLocalitiesBelowMinimumThreshold
    • annualLiceStatistics - replaces localitiesAboveLiceLimitAnnual
      • liceStatistics - replaces totalLocalitiesAboveLiceLimitCount
      • filteredLiceStatistics - replaces includedLocalitiesAboveLiceLimitCount
      • weeklyLiceStatistics - replaces localitiesAboveLiceLimitCount

  • POST /v2/geodata/fishhealth/locality/{year}/{week}

    Replaces GET /v1/geodata/fishhealth/locality/{year}/{week}

    • year and week - no longer available
    • diseases - replaces hasIla and hasPd
    • geometry - replaces lat and lon
    • liceReport
      • hasReported - replaces hasReportedLice
      • isFallow - replaces + relocates isFallow
      • adultFemaleLice
        • average - replaces avgAdultFemaleLice
        • averageOfPreviousWeek - new property
      • mobileLice - new property
      • stationaryLice - new property
      • totalLice - new property
    • liceTreatments - replaces hasCleanerfishDeployed, hasMechanicalRemoval and hasSubstanceTreatments
    • hasSalmonoidLicense - replaces hasSalmonoids
    • locality - replaces localityNo, name and isOnLand
    • municipality - replaces municipalityNo and municipality

  • GET /v2/geodata/fishhealth/locality/{localityNo}/{year}/{week}

    Replaces GET /v1/geodata/fishhealth/locality/{localityNo}/{year}/{week}

    • localityWeek
      • hasBathTreatment, hasCleanerFishDeployed, hasInFeedTreatment and hasMechanicalRemoval - no longer available (see liceTreatments)
    • aquaCultureRegister
      • hasSalmonoidLicense - replaces localityWeek.hasSalmonoids
      • hasGreenLicense - replaces aquaCultureRegister.isGreen
      • isSlaughterHoldingCage - replaces localityWeek.isSlaughterHoldingCage
      • productionTypes - a list instead of a comma-delimited text
      • purposes - a list instead of a comma-delimited text
      • species - a list instead of a comma-delimited text
      • speciesList - no longer available (see species)
    • controlAreas - replaces ilaSurveillanceZones, ilaProtectionZones, pdSurveillanceZones and pdProtectionZones
    • diseases - replaces ilaPd and ilaPdCase
      • version - new property
        • version = 1: previously ilaPd
          • name - replaces disease
          • status - replaces ruling
          • suspicionDate - replaces fromDate when status=SUSPECTED
          • diagnosisDate - replaces fromDate when status=DIAGNOSED
          • closureDate - replaces toDate
        • version = 2: previously ilaPdCase
          • name - replaces disease
          • subType - replaces subtype
          • createdDate - no longer available
          • changedDate - no longer available
          • suspicionDate - replaces suspectedDate
          • diagnosisDate - replaces confirmedDate
          • disproved - no longer available
          • disprovedDate - no longer available
          • closureDate - replaces closedDate
        • version = 3: disease cases after 2024 week 49
    • farmedFishEscapes - replaces escapes
    • geometry - replaces lat and lon
    • liceReport
      • hasReported - replaces localityWeek.hasReportedLice
      • isFallow - replaces localityWeek.isFallow
      • adultFemaleLice
        • average - replaces localityWeek.avgAdultFemaleLice
        • averageOfPreviousWeek - replaces liceCountPreviousWeek.avgAdultFemaleLice
      • mobileLice
        • average - replaces localityWeek.avgMobileLice
        • averageOfPreviousWeek - replaces liceCountPreviousWeek.avgMobileLice
      • stationaryLice
        • average - replaces localityWeek.avgStationaryLice
        • averageOfPreviousWeek - replaces liceCountPreviousWeek.avgStationaryLice
      • totalLice - new property
      • seaTemperature - replaces localityWeek.seaTemperature
    • liceTreatments
      • combinationTreatments - replaces localityWeek.combinationTreatments
      • medicinalTreatments - replaces localityWeek.medicinalTreatments
      • nonMedicinalTreatments - replaces localityWeek.nonMedicinalTreatments
      • bathTreatments - replaces localityWeek.bathTreatments
      • cleanerFishTreatment - replaces localityWeek.cleanerFish
      • inFeedTreatments - replaces localityWeek.inFeedTreatments
      • mechanicalRemovalTreatment - replaces localityWeek.mechanicalRemoval
      • daysSinceLastChitinSynthesisInhibitorTreatment - replaces timeSinceLastChitinSynthesisInhibitorTreatment
    • locality - replaces aquaCultureRegister.name, aquaCultureRegister.localityNo
    • municipality - replaces aquaCultureRegister.municipalityNo and aquaCultureRegister.municipality
    • productionArea - certain properties are no longer available

  • GET /v3/geodata/fishhealth/locality/{localityNo}/disease/{year}

    Replaces GET /v2/geodata/fishhealth/locality/{localityNo}/disease/{year}

    • name - replaces disease
    • subType - replaces subtype
    • version - new property
    • suspicionDate - replaces suspectedDate
    • diagnosisDate - replaces confirmedDate
    • disproved - no longer available
    • disprovedDate - no longer available
    • closureDate - replaces closedDate