> ## Documentation Index
> Fetch the complete documentation index at: https://help.polygon-one.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Parzelle abrufen

> Retrieve a single plot including its geometry (`geojson`) and its linked `supplierArticleIds`. Requires `plots:read`. The full analysis payload and the image-space fields (`analysisResult`, `pixelCoords`, `imageWidth`, `imageHeight`) are not returned to API keys.



## OpenAPI

````yaml GET /api/plots/{id}
openapi: 3.1.0
info:
  title: Polygon One Compliance API
  description: >-
    API for integrating ERP systems with the Polygon One EUDR Compliance
    Platform. Allows management of Articles, Suppliers, Orders, and Due
    Diligence Statements (DDS). PPWR packaging master data, the SKU quantity
    feed and Mengenmeldung reports are covered by the PPWR groups.
  version: 1.0.0
servers:
  - url: https://app.polygon-one.com
    description: Production Server
security:
  - bearerAuth: []
paths:
  /api/plots/{id}:
    get:
      summary: Get Plot by ID
      description: >-
        Retrieve a single plot including its geometry (`geojson`) and its linked
        `supplierArticleIds`. Requires `plots:read`. The full analysis payload
        and the image-space fields (`analysisResult`, `pixelCoords`,
        `imageWidth`, `imageHeight`) are not returned to API keys.
      operationId: getPlot
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Plot details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Plot'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    Plot:
      type: object
      description: >-
        A single plot as returned to an API key. The full analysis payload
        (`analysisResult`) and the image-space fields (`pixelCoords`,
        `imageWidth`, `imageHeight`) are not part of the API response.
      properties:
        id:
          type: string
          format: uuid
        companyId:
          type: string
          format: uuid
        createdByUserId:
          type: string
          format: uuid
        name:
          type: string
        country:
          type: string
          description: Country of production (ISO 3166-1 alpha-2, e.g. `BR`).
        size:
          type: number
          description: Area in hectares. `0` when no size is stored.
        requiresAreaPlausibilityReview:
          type: boolean
          description: >-
            The declared size and the geometry do not fit together and need a
            manual review.
        species:
          type: array
          items:
            $ref: '#/components/schemas/PlotSpecies'
        commodityGroup:
          $ref: '#/components/schemas/CommodityGroup'
        producerName:
          type: string
        productionDateFrom:
          type: string
          format: date-time
        productionDateTo:
          type: string
          format: date-time
        analysisStatus:
          type: string
          enum:
            - pending
            - in_progress
            - completed
            - failed
            - exempt
            - skipped
          description: >-
            State of the geospatial deforestation analysis. A new plot starts at
            `pending`; the analysis runs asynchronously.
        deforestationRiskResult:
          type:
            - integer
            - 'null'
          enum:
            - 0
            - 1
            - 2
            - null
          description: >-
            Analysis result: `0` = low, `1` = high, `2` = moderate risk. `null`
            while no result is available.
        forestPercentage:
          type: number
        isDegraded:
          type:
            - boolean
            - 'null'
        createdAt:
          type:
            - string
            - 'null'
          format: date-time
        updatedAt:
          type:
            - string
            - 'null'
          format: date-time
        geojson:
          type: object
          description: >-
            The plot geometry as GeoJSON (a Feature or a bare Geometry, WGS84
            longitude/latitude).
        supplierArticleIds:
          type: array
          items:
            type: string
            format: uuid
          description: Supplier articles (supplier ↔ article links) this plot is linked to.
        importSourceFormat:
          type: string
          description: Source format when the plot came from a file import.
        importPrecisionClass:
          type: string
          description: Coordinate-precision class determined at import.
        importPrecisionDigits:
          type: number
          description: Decimal digits of the imported coordinates.
        importPrecisionAcceptedAt:
          type: string
          description: When a low import precision was accepted.
          format: date-time
        importPrecisionAcceptedBy:
          type: string
          description: User who accepted a low import precision.
          format: uuid
        importPrecisionAcceptedByName:
          type: string
          description: Name of that user.
        importOriginalCentroidLng:
          type: number
          description: Centroid longitude of the geometry as imported.
        importOriginalCentroidLat:
          type: number
          description: Centroid latitude of the geometry as imported.
    PlotSpecies:
      type: object
      required:
        - commonName
        - scientificName
      properties:
        commonName:
          type: string
          maxLength: 200
          description: Common (trade) name, e.g. `Oak`.
        scientificName:
          type: string
          maxLength: 200
          description: Scientific (Latin) name, e.g. `Quercus robur`.
    CommodityGroup:
      type: string
      enum:
        - cattle
        - cocoa
        - coffee
        - oil_palm
        - rubber
        - soya
        - wood
        - non_relevant
      description: >-
        EUDR-regulated commodity groups. `non_relevant` = article is not covered
        by EUDR.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        details:
          description: Additional error details (e.g. validation issues)
      required:
        - error
  responses:
    BadRequest:
      description: Invalid request data
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: Insufficient permissions for this resource
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        API key generated in Settings > API Keys. Include as `Authorization:
        Bearer <key>`.

````