Skip to main content

Limit on licereport download (2026-03-24)

Anders Bakkevold
BarentsWatch forvaltningsteam

The endpoint v1/geodata/download/fishhealth have been updated to restrict the time range when downloading all locality data with reporttype 'licereport'. The maximum time range is now 1 year and 1 week. Longer time ranges will result in 400 bad request. When specifying localityno there is no maximum time range.

Removal of obsolete waveforecast endpoints (2026-03-10)

Anders Bakkevold
BarentsWatch forvaltningsteam

Four waveforecast endpoints will be removed after April 12, 2026. These endpoints have been marked as obsolete for an extended period and have replacement endpoints available (v2).

The endpoints that will be removed are:

  • v1/geodata/waveforecast/fairway
  • v1/geodata/waveforecast/
  • v1/geodata/currentwaves-points
  • v1/geodata/currentwaves-point/{name}

Filtering of AIS data (2026-02-02)

Anders Bakkevold
BarentsWatch forvaltningsteam

Satellite positions are now filtered from the track endpoints, if the vessel has a recent position from onshore or offshore receivers. The satellite message has lower position precision, so the position from onshore or offshore recievers is the preferred position.

A filterSatellitePositions query parameter has been added to the /v1/historic/tracks/{mmsi}/{fromDate}/{toDate} endpoint, if you want to disable the filter and get all positions: https://historic.ais.barentswatch.no/index.html

New point forecast endpoints (2026-01-20)

Anders Bakkevold
BarentsWatch forvaltningsteam

Three new endpoints for point forecasts have been added to the Waveforecast API:

  • v1/seacurrent/nearest
  • v1/seacurrent/nearest/all
  • v1/windforecastpoint/nearest/all

They are similary to these existing endpoints:

  • /v1/waveforecastpoint/nearest
  • /v1/waveforecastpoint/nearest/all

See API documentation for details: https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=Waveforecast+API#/ForecastPoint

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

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