> ## 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.

# Parzellen auflisten

> Retrieve one page of your company's plots (EUDR production plots), ordered by `id`. Requires `plots:read`.

The list rows carry **no geometry** (`geojson`), **no** `supplierArticleIds` and no analysis payload or pixel data — read a single plot with `GET /api/plots/{id}` for geometry and links. Deleted plots are never listed.

The response is bounded: `limit` defaults to 100 and may be at most 1000. Page with `offset` until a page returns fewer rows than `limit`. Plots created or deleted while you page can shift the offsets.



## OpenAPI

````yaml GET /api/plots
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:
    get:
      summary: List Plots
      description: >-
        Retrieve one page of your company's plots (EUDR production plots),
        ordered by `id`. Requires `plots:read`.


        The list rows carry **no geometry** (`geojson`), **no**
        `supplierArticleIds` and no analysis payload or pixel data — read a
        single plot with `GET /api/plots/{id}` for geometry and links. Deleted
        plots are never listed.


        The response is bounded: `limit` defaults to 100 and may be at most
        1000. Page with `offset` until a page returns fewer rows than `limit`.
        Plots created or deleted while you page can shift the offsets.
      operationId: listPlots
      parameters:
        - name: limit
          in: query
          description: >-
            Maximum number of plots to return. Default 100, maximum 1000 — a
            larger value is rejected with `400`.
          schema:
            type: integer
            default: 100
            minimum: 1
            maximum: 1000
        - name: offset
          in: query
          description: Number of plots to skip for pagination.
          schema:
            type: integer
            default: 0
            minimum: 0
      responses:
        '200':
          description: List of plots
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PlotListItem'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    PlotListItem:
      type: object
      description: >-
        A plot as returned by `GET /api/plots`. Carries **no** `geojson` and
        **no** `supplierArticleIds` — the fields are absent, not empty. Read one
        plot with `GET /api/plots/{id}` to get both.
      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
    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'
    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>`.

````