# Phytosanitary

Endpoints for phytosanitary monitoring and analysis (pest/disease tracking)

## Get phytosanitary monitoring summary

 - [GET /api/control/phytosanitary/summary](https://docs.hydrobit.ag/spec/openapi/phytosanitary/getphytosanitarysummary.md): Retrieves aggregated phytosanitary data (pest and disease incidence/severity) for a specified time range.

Requires API token authentication with read:phytosanitary scope via the x-api-key header.

Key features:
- Aggregates data from phytosanitary form records
- Supports filtering by company, project, or sector
- Returns incidence and severity metrics per sector
- Maximum range: 180 days
- Dates must be in YYYY-MM-DD format (local time, no timezone suffix)
- Timezone is automatically resolved from the project settings

## Get phytosanitary summary for entire company

 - [GET /api/control/phytosanitary/company-summary](https://docs.hydrobit.ag/spec/openapi/phytosanitary/getphytosanitarycompanysummary.md): Retrieves aggregated phytosanitary data (pest and disease incidence/severity) for all projects and sectors belonging to the authenticated company within a specified time range.

Requires API token authentication with read:phytosanitary scope via the x-api-key header.

Key features:
- Automatically uses companyId from the authenticated API token
- Aggregates data from all projects and sectors belonging to the company
- Returns incidence and severity metrics grouped by project and sector
- Maximum range: 180 days
- Dates must be in YYYY-MM-DD format (local time, no timezone suffix)
- Timezone is automatically resolved from the company's projects
- No need to specify companyId, projectId, or sectorId manually

## Get all phytosanitary records for the company

 - [GET /api/control/phytosanitary/company-records](https://docs.hydrobit.ag/spec/openapi/phytosanitary/getphytosanitarycompanyrecords.md): Retrieves all individual phytosanitary monitoring records for the authenticated company within a specified time range.

Unlike /company-summary which returns aggregated incidence/severity metrics, this endpoint returns the raw records with full detail: dates, user information, location, and each pest/disease response.

Requires API token authentication with read:phytosanitary scope via the x-api-key header.

Key features:
- Automatically uses companyId from the authenticated API token
- Returns individual records (not aggregated)
- Each record includes: dates, user id/name, project, sector, crop, coordinates
- Each record includes its pest/disease responses with value and severity
- Maximum range: 180 days
- Dates must be in YYYY-MM-DD format (local time, no timezone suffix)