# Get jurisdictions

Retrieves a paginated list of jurisdictions matching the specified filters.
Jurisdictions are administrative regions with pre-computed deforestation risk assessments.

Use this endpoint to:
* Find jurisdictions by country and risk level
* Filter by presence of risk factors (remaining forest, protected areas, indigenous territories)
* Get jurisdiction-level deforestation data for a specific regulatory framework

Results are paginated with 100 jurisdictions per page. Use the nextUrl in the response to fetch subsequent pages.

Endpoint: GET /v1/jurisdictions
Version: v1
Security: bearerAuth

## Query parameters:

  - `framework` (string, required)
    The regulatory framework cutoff date to use for risk assessment
    Enum: "NPDE", "CFI", "RSPO", "EUDR", "Fairtrade"

  - `riskLevel` (string)
    Comma-separated list of risk levels to filter by (maximum 3). Values are none, low, medium, high.
    Example: "low,medium,high"

  - `country` (string)
    Comma-separated list of ISO 3166-1 alpha-2 country codes to filter by (maximum 5)
    Example: "BR,ID,CO"

  - `hasRemainingForest` (boolean)
    Filter for jurisdictions with remaining forest presence

  - `hasProtectedAreas` (boolean)
    Filter for jurisdictions with protected areas presence

  - `hasIndigenousTerritories` (boolean)
    Filter for jurisdictions with indigenous territories presence

  - `cursor` (string)
    Pagination cursor for fetching subsequent pages of results

## Response 200 fields (application/json):

  - `count` (integer)
    Number of jurisdictions in the current page
    Example: 100

  - `nextUrl` (string,null)
    URL to fetch the next page of results, null if no more results

  - `results` (array)

  - `results.id` (string)
    Internal Satelligence identifier for the jurisdiction

  - `results.name` (string)
    Display name of the jurisdiction
    Example: "Acre"

  - `results.administrationLevel` (integer)
    GADM administration level (0=country, 1=state/province, 2=district, etc.)
    Example: 1

  - `results.administrationUnitName` (string)
    Name of the administration unit type at this level
    Example: "State"

  - `results.gadmId` (string)
    GADM identifier for this jurisdiction
    Example: "BRA.1_1"

  - `results.areaHa` (number)
    Total area of the jurisdiction in hectares
    Example: 16493200

  - `results.country` (string)
    ISO 3166-1 alpha-2 country code
    Example: "BR"

  - `results.boundingBox` (object)

  - `results.boundingBox.minLng` (number)
    Minimum longitude

  - `results.boundingBox.minLat` (number)
    Minimum latitude

  - `results.boundingBox.maxLng` (number)
    Maximum longitude

  - `results.boundingBox.maxLat` (number)
    Maximum latitude

  - `results.assessment` (object)

  - `results.assessment.assessmentDate` (string)
    Date of the assessment (YYYY-MM-DD)
    Example: "2024-01-15"

  - `results.assessment.framework` (string)
    Supported cutoff dates
    Enum: "NPDE", "CFI", "RSPO", "EUDR", "Fairtrade"

  - `results.assessment.riskLevel` (string)
    Deforestation risk level for a jurisdiction
    Enum: "none", "low", "medium", "high"

  - `results.assessment.deforestation` (object)

  - `results.assessment.deforestation.areaHa` (number)
    Total deforestation area in hectares since the cutoff date

  - `results.assessment.deforestation.hasDeforestation` (boolean)
    Whether any deforestation was detected since the cutoff date

  - `results.assessment.commodities` (object)
    Commodity-specific land cover and deforestation data

  - `results.assessment.commodities.cocoa` (object)

  - `results.assessment.commodities.cocoa.areaHa` (number)
    Area of this commodity in hectares

  - `results.assessment.commodities.cocoa.deforestationHa` (number)
    Deforestation within this commodity area in hectares since the cutoff date

  - `results.assessment.commodities.coffee` (object)

  - `results.assessment.commodities.oilPalm` (object)

  - `results.assessment.commodities.soy` (object)

  - `results.assessment.commodities.rubber` (object)

  - `results.assessment.commodities.sugarCane` (object)

  - `results.assessment.riskFactors` (object)
    Risk factor presence and area data

  - `results.assessment.riskFactors.protectedAreas` (object)

  - `results.assessment.riskFactors.protectedAreas.areaHa` (number)
    Area in hectares

  - `results.assessment.riskFactors.protectedAreas.hasPresence` (boolean)
    Whether this risk factor is present in the jurisdiction

  - `results.assessment.riskFactors.indigenousTerritories` (object)

  - `results.assessment.riskFactors.remainingForest` (object)

  - `results.assessment.monthToLandCoverToDeforestationHa` (object)
    Monthly deforestation breakdown by commodity since the cutoff date. Keys are month strings (YYYY-MM).


## Response 400 fields

## Response 401 fields

## Response 404 fields