What's New in v4

Version 4 introduces several enhancements and new endpoints:

• Protected and Conserved Area Parcels: New endpoints for accessing individual parcels within protected and conserved areas
• Updated Data Structure: Updated field names and additional attributes for improved clarity. Please see below for field changes

Migration from v3

Important: While v4 introduces breaking changes (mainly field name changes), v3 will remain available until the time mentioned above to allow time for migration. Please review the changes below and update your integration accordingly.

Protected and Conserved Areas Response Changes

Fields Removed:

• id → site_id - Previously an alias for wdpa_id. Use site_id in v4
• sub_locations - Sub-location data is no longer captured for protected and conserved areas

Fields Renamed:

• wdpa_id → site_id
• wdpa_pid → site_pid - It is 'string' format in v4
• name → name_english - English name of the protected area
• original_name → name - Original name in local language
• marine_type → realm - See next section for return values

Fields Added:

• site_type - Distinguishes between protected areas ('pa') and other effective area-based conservation measures ('oecm'). (Return either value of pa, oecm)
• realm - Indicates the environmental domain. Returns an object with id and name fields. Name values include Terrestrial, Coastal, Marine
• governance_subtype - Additional governance classification details (String)
• ownership_subtype - Additional ownership classification details (String)
• inland_waters - Information about Information about inland water management measures (String)
• oecm_assessment - Assessment information for OECMs (String)
• sources - Array containing data source information with id, title, responsible_party, and year_updated fields
• protected_area_parcels - Array containing detailed information for all parcels within the protected or conserved area. Returns an empty array if no parcels exist. See Parcel Integration section below for detailed structure

API URL Changes:

• v3: /v3/*
• v4: /v4/*

Countries API

• No changes - The Countries API maintains identical response structure and fields between v3 and v4

New Features in v4

Protected and Conserved Area Parcels

• New Resource: Complete new set of endpoints for accessing individual parcels within protected and conserved areas.
• Enhanced Detail: Access granular data for each parcel that makes up a protected or conserved area.
• Comprehensive Coverage: All protected and conserved area endpoints now include a protected_area_parcels array

Parcel Integration

• Protected and conserved area responses now include a protected_area_parcels array containing all parcels
• The primary protected or conserved area data represents the first parcel
• The protected_area_parcels array includes all parcels (including the first one) for complete coverage
• Each parcel object contains similar structure as the main protected or conserved area object. See example response structure