# List analysis runs for a plot

Returns all analysis runs associated with the provided plot_id. Each item summarizes the run, including status, timing, tokens cost, and links to artifacts.

Endpoint: GET /analysis-runs
Version: 3.0.1

## Query parameters:

  - `plot_id` (string, required)
    Plot ID to list runs for

  - `plot_id` (string)

## Header parameters:

  - `Authorization` (string)
    Authorization header with a Bearer token, formatted as 'Bearer [JWT]' where [JWT] is the JSON Web Token used for user authentication and authorization.
    Example: "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.your-payload-here.signature"

## Response 200 fields (application/json):

  - `run_id` (string)

  - `job_id` (string)

  - `plot_id` (string)

  - `check_type` (string)

  - `effective_config` (object)

  - `status` (string)

  - `error` (string)

  - `analysis_image` (string)

  - `tokens_cost` (integer)

  - `created_at` (string)

  - `updated_at` (string)

  - `analysis` (object)
    Complete analysis data for a plot

  - `analysis.analysisEnd` (string)
    End date of the analysis
    Example: "2024-02-29"

  - `analysis.analysis_end` (string)
    End date of the analysis
    Example: "2024-02-29"

  - `analysis.risk_level` (string)
    Risk level assessment
    Example: "Low"

  - `analysis.forest_percentage_2020` (number)
    Forest percentage in 2020
    Example: 93.07

  - `analysis.indigenous_land` (object)
    Analysis of indigenous lands overlapping with a plot

  - `analysis.indigenous_land.indigenous_land_overlap_summary` (object)
    Summary of indigenous land overlap with plot

  - `analysis.indigenous_land.indigenous_land_overlap_summary.indigenous_land_overlap` (boolean, required)
    Indicates if the plot overlaps with any indigenous land

  - `analysis.indigenous_land.indigenous_land_overlap_summary.total_overlap_percentage` (number)
    Percentage of plot area that overlaps with indigenous land
    Example: 25.3

  - `analysis.indigenous_land.indigenous_land_overlap_summary.total_overlap_area_ha` (number)
    Plot area (in hectares) that overlaps with indigenous land
    Example: 155.3

  - `analysis.indigenous_land.indigenous_land_details` (array)
    Detailed information about each overlapping indigenous land

  - `analysis.indigenous_land.indigenous_land_details.id` (string, required)
    Unique identifier of the indigenous land
    Example: "IL-202"

  - `analysis.indigenous_land.indigenous_land_details.name` (string)
    Name of the indigenous land
    Example: "Yanomami Territory"

  - `analysis.indigenous_land.indigenous_land_details.government_acknowledged` (boolean)
    Acknowledgment of government
    Example: true

  - `analysis.indigenous_land.indigenous_land_details.overlap_area_ha` (number)
    Overlap area in hectares
    Example: 3.1

  - `analysis.indigenous_land.indigenous_land_details.land_status` (string)
    Status of the land, e.g. 'Community'
    Example: "Community"

  - `analysis.indigenous_land.sources` (array)
    Sources of indigenous land data

  - `analysis.indigenous_land.sources.source_name` (string, required)
    Name of the data source
    Example: "CNUC"

  - `analysis.indigenous_land.sources.data_version` (string)
    Version or date of the data
    Example: "2024-11-20"

  - `analysis.logging_area` (number)
    Logging area in hectares
    Example: 1.08

  - `analysis.forest_area_2020` (number)
    Forest area in 2020 in hectares
    Example: 145.31

  - `analysis.risk_reason` (string)
    Reason for risk assessment
    Example: "Low: Low deforestation detection"

  - `analysis.version` (string)
    Version of the analysis
    Example: "2024-11-13"

  - `analysis.areaHa` (number)
    Total area in hectares
    Example: 156.13

  - `analysis.protected_areas` (object)
    Analysis of protected areas overlapping with a plot

  - `analysis.protected_areas.protected_area_overlap_summary` (object)
    Summary of protected area overlap with plot

  - `analysis.protected_areas.protected_area_overlap_summary.protected_area_overlap` (boolean, required)
    Indicates if the plot overlaps with any protected area

  - `analysis.protected_areas.protected_area_overlap_summary.total_overlap_percentage` (number)
    Percentage of plot area that overlaps with protected areas
    Example: 25.3

  - `analysis.protected_areas.protected_area_overlap_summary.total_overlap_area_ha` (number)
    Plot area (in hectares) that overlaps with protected areas
    Example: 155.3

  - `analysis.protected_areas.protected_area_overlap_summary.most_restrictive_extractive_activity_legality` (string)
    Legality status of the most restrictive extractive activities of all the extractive activities returned with the protected areas
    Example: "prohibited"

  - `analysis.protected_areas.protected_area_details` (array)
    Detailed information about each overlapping protected area

  - `analysis.protected_areas.protected_area_details.area_id` (string, required)
    Unique identifier of the protected area
    Example: "37514"

  - `analysis.protected_areas.protected_area_details.area_name` (string)
    Name of the protected area
    Example: "Cordillera Beata"

  - `analysis.protected_areas.protected_area_details.local_name` (string)
    Local name of the protected area
    Example: "Cordillera Beata"

  - `analysis.protected_areas.protected_area_details.source_name` (string)
    Source/authority providing the protected area data
    Example: "Parques Nacionales Naturales de Colombia"

  - `analysis.protected_areas.protected_area_details.iucn_category` (string)
    IUCN protected area category
    Enum: "Ia", "Ib", "II", "III", "IV", "V", "VI"

  - `analysis.protected_areas.protected_area_details.overlap_area_ha` (number)
    Area of overlap in hectares
    Example: 2208.6384

  - `analysis.protected_areas.protected_area_details.extractive_activity_legality` (string)
    Legality status of extractive activities within the protected area
    Example: "limited"

  - `analysis.protected_areas.protected_area_details.extractive_activity_conditions` (string)
    Conditions or notes describing what extractive activities are permitted
    Example: "Activities permitted: Research, education, and eco-tourism."

  - `analysis.protected_areas.protected_area_details.regulation_names` (array)
    Names/titles of applicable regulations
    Example: ["DECRETO 622 DE MARZO 16 DE 1977","LEY 99 DE 1993"]

  - `analysis.protected_areas.protected_area_details.regulation_urls` (array)
    URLs linking to applicable regulations
    Example: ["https://old.parquesnacionales.gov.co/portal/wp-content/uploads/2018/07/Decreto_622_de_1977.pdf","https://www.minambiente.gov.co/wp-content/uploads/2021/08/ley-99-1993.pdf","https://www.funcionpublica.gov.co/eva/gestornormativo/norma.php"]

  - `analysis.protected_areas.protected_area_details.type` (string)
    Type/classification of the protected area
    Example: "Reserva Natural"

  - `analysis.protected_areas.sources` (array)
    Sources of protected area data

  - `analysis.deforestation` (object)
    Deforestation data for a plot

  - `analysis.deforestation.total_yearly` (object)
    Total yearly deforestation data

  - `analysis.deforestation.total_yearly_jrc` (object)
    Total yearly JRC deforestation data

  - `analysis.deforestation.total` (number)
    Total deforestation
    Example: 0.069

  - `analysis.deforestation.total_jrc` (number)
    Total JRC deforestation
    Example: 0.069

  - `analysis.deforestation_percentage` (number)
    Deforestation percentage
    Example: 0.044

  - `analysis.protectedAreas` (array)
    List of protected area names and their overlap areas in hectares
    Example: [["Área De Proteção Ambiental",0.24],["Rio Negro",156.13]]

  - `analysis.indigenous_overlap` (object)
    Indigenous territories overlap analysis

  - `analysis.indigenous_overlap.total_overlap_area` (number)
    Total area of overlap with indigenous territories in hectares
    Example: 150.5

  - `analysis.indigenous_overlap.overlapping_territories` (array)
    List of overlapping indigenous territories

  - `analysis.indigenous_overlap.overlap_percentage` (number)
    Percentage of overlap with indigenous territories
    Example: 25.5


## Response 400 fields

## Response 403 fields

## Response 404 fields

## Response 500 fields