> ## Documentation Index
> Fetch the complete documentation index at: https://docs.assetinfinity.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Property handed in, where it is kept, how long it has been there, and who took it away.



## OpenAPI

````yaml /api-reference/openapi.json get /found_items
openapi: 3.0.0
info:
  description: ''
  title: >-
    The only schema PostgREST exposes (ADR-014). Reads are security_invoker
    views; writes are SECURITY DEFINER functions. Rebuilt wholesale on every
    deploy — it holds no data.
  version: 12.2.3
servers:
  - url: https://app.assetinfinity.ai/api
security: []
tags:
  - name: Signing in
  - name: Profile
  - name: Assets
  - name: Asset lifecycle
  - name: Work lifecycle
  - name: Maintenance
  - name: Inventory
  - name: Inventory detail
  - name: Procurement
  - name: Contracts
  - name: Workforce
  - name: Capacity
  - name: Dispatch
  - name: Routing
  - name: Tools
  - name: Inspections
  - name: Verification
  - name: Reliability
  - name: Parts demand
  - name: Sensors and meters
  - name: Map
  - name: Floor plans
  - name: Labels
  - name: Lost and found
  - name: Root cause analysis
  - name: Reports
  - name: Audit center
  - name: Activity
  - name: Notifications
  - name: Channels
  - name: Search
  - name: Copilot
  - name: Import
  - name: Files
  - name: Sync
  - name: Support
  - name: Admin
  - name: Access
  - name: Lookups
  - name: Read models
  - name: Branding
  - name: Custom fields
  - name: Form studio
  - name: Workflows
  - name: Workflow studio
  - name: Rules
  - name: Statuses and transitions
  - name: Currencies and locales
  - name: Work configuration
  - name: Asset configuration
  - name: Inventory configuration
  - name: Tool configuration
  - name: Workforce configuration
  - name: Vendor and contract configuration
  - name: Document configuration
  - name: Inspection configuration
  - name: Sites, locations and the organisation
  - name: Platform
  - name: Self verification
  - name: Setup
  - name: Tools on a job, and who has them out
  - name: Vendors and contracts
  - name: Work order execution
  - name: Workforce detail
externalDocs:
  description: PostgREST Documentation
  url: https://postgrest.org/en/v12/references/api.html
paths:
  /found_items:
    get:
      tags:
        - Lost and found
      summary: >-
        Property handed in, where it is kept, how long it has been there, and
        who took it away.
      parameters:
        - $ref: '#/components/parameters/rowFilter.found_items.id'
        - $ref: '#/components/parameters/rowFilter.found_items.reference'
        - $ref: '#/components/parameters/rowFilter.found_items.status'
        - $ref: '#/components/parameters/rowFilter.found_items.site_id'
        - $ref: '#/components/parameters/rowFilter.found_items.site_code'
        - $ref: '#/components/parameters/rowFilter.found_items.site_name'
        - $ref: '#/components/parameters/rowFilter.found_items.found_location_id'
        - $ref: '#/components/parameters/rowFilter.found_items.found_location_name'
        - $ref: '#/components/parameters/rowFilter.found_items.found_location_detail'
        - $ref: '#/components/parameters/rowFilter.found_items.found_at'
        - $ref: '#/components/parameters/rowFilter.found_items.handed_in_at'
        - $ref: '#/components/parameters/rowFilter.found_items.found_by_name'
        - $ref: '#/components/parameters/rowFilter.found_items.found_by_kind'
        - $ref: '#/components/parameters/rowFilter.found_items.found_by_phone'
        - $ref: '#/components/parameters/rowFilter.found_items.found_by_user_id'
        - $ref: '#/components/parameters/rowFilter.found_items.lost_found_category_id'
        - $ref: '#/components/parameters/rowFilter.found_items.category'
        - $ref: '#/components/parameters/rowFilter.found_items.item_description'
        - $ref: '#/components/parameters/rowFilter.found_items.brand'
        - $ref: '#/components/parameters/rowFilter.found_items.colour'
        - $ref: '#/components/parameters/rowFilter.found_items.serial_number'
        - $ref: '#/components/parameters/rowFilter.found_items.distinguishing_marks'
        - $ref: '#/components/parameters/rowFilter.found_items.quantity'
        - $ref: '#/components/parameters/rowFilter.found_items.estimated_value'
        - $ref: >-
            #/components/parameters/rowFilter.found_items.estimated_value_currency_id
        - $ref: '#/components/parameters/rowFilter.found_items.is_valuable'
        - $ref: '#/components/parameters/rowFilter.found_items.storage_location_id'
        - $ref: '#/components/parameters/rowFilter.found_items.storage_location_name'
        - $ref: '#/components/parameters/rowFilter.found_items.storage_detail'
        - $ref: '#/components/parameters/rowFilter.found_items.stored_by_user_id'
        - $ref: '#/components/parameters/rowFilter.found_items.stored_by'
        - $ref: '#/components/parameters/rowFilter.found_items.hold_until'
        - $ref: '#/components/parameters/rowFilter.found_items.days_held'
        - $ref: '#/components/parameters/rowFilter.found_items.hold_expired'
        - $ref: '#/components/parameters/rowFilter.found_items.lost_item_report_id'
        - $ref: '#/components/parameters/rowFilter.found_items.lost_reference'
        - $ref: '#/components/parameters/rowFilter.found_items.owner_name'
        - $ref: '#/components/parameters/rowFilter.found_items.owner_phone'
        - $ref: '#/components/parameters/rowFilter.found_items.owner_email'
        - $ref: '#/components/parameters/rowFilter.found_items.matched_at'
        - $ref: '#/components/parameters/rowFilter.found_items.matched_by_user_id'
        - $ref: '#/components/parameters/rowFilter.found_items.match_notes'
        - $ref: '#/components/parameters/rowFilter.found_items.collected_by_name'
        - $ref: '#/components/parameters/rowFilter.found_items.collected_by_id_type'
        - $ref: '#/components/parameters/rowFilter.found_items.collected_by_id_number'
        - $ref: '#/components/parameters/rowFilter.found_items.collected_at'
        - $ref: '#/components/parameters/rowFilter.found_items.released_by_user_id'
        - $ref: '#/components/parameters/rowFilter.found_items.released_by'
        - $ref: '#/components/parameters/rowFilter.found_items.collection_notes'
        - $ref: '#/components/parameters/rowFilter.found_items.disposed_at'
        - $ref: '#/components/parameters/rowFilter.found_items.disposal_method'
        - $ref: '#/components/parameters/rowFilter.found_items.disposal_notes'
        - $ref: '#/components/parameters/rowFilter.found_items.notes'
        - $ref: '#/components/parameters/rowFilter.found_items.standing'
        - $ref: '#/components/parameters/rowFilter.found_items.primary_image_file_id'
        - $ref: '#/components/parameters/rowFilter.found_items.row_version'
        - $ref: '#/components/parameters/rowFilter.found_items.created_at'
        - $ref: '#/components/parameters/rowFilter.found_items.updated_at'
        - $ref: '#/components/parameters/select'
        - $ref: '#/components/parameters/order'
        - $ref: '#/components/parameters/range'
        - $ref: '#/components/parameters/rangeUnit'
        - $ref: '#/components/parameters/offset'
        - $ref: '#/components/parameters/limit'
        - $ref: '#/components/parameters/preferCount'
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/found_items'
                type: array
            application/vnd.pgrst.object+json:
              schema:
                items:
                  $ref: '#/components/schemas/found_items'
                type: array
            application/vnd.pgrst.object+json;nulls=stripped:
              schema:
                items:
                  $ref: '#/components/schemas/found_items'
                type: array
            text/csv:
              schema:
                items:
                  $ref: '#/components/schemas/found_items'
                type: array
          description: OK
        '206':
          description: Partial Content
components:
  parameters:
    rowFilter.found_items.id:
      in: query
      name: id
      required: false
      schema:
        type: string
    rowFilter.found_items.reference:
      in: query
      name: reference
      required: false
      schema:
        type: string
    rowFilter.found_items.status:
      in: query
      name: status
      required: false
      schema:
        type: string
    rowFilter.found_items.site_id:
      in: query
      name: site_id
      required: false
      schema:
        type: string
    rowFilter.found_items.site_code:
      in: query
      name: site_code
      required: false
      schema:
        type: string
    rowFilter.found_items.site_name:
      in: query
      name: site_name
      required: false
      schema:
        type: string
    rowFilter.found_items.found_location_id:
      in: query
      name: found_location_id
      required: false
      schema:
        type: string
    rowFilter.found_items.found_location_name:
      in: query
      name: found_location_name
      required: false
      schema:
        type: string
    rowFilter.found_items.found_location_detail:
      in: query
      name: found_location_detail
      required: false
      schema:
        type: string
    rowFilter.found_items.found_at:
      in: query
      name: found_at
      required: false
      schema:
        type: string
    rowFilter.found_items.handed_in_at:
      in: query
      name: handed_in_at
      required: false
      schema:
        type: string
    rowFilter.found_items.found_by_name:
      in: query
      name: found_by_name
      required: false
      schema:
        type: string
    rowFilter.found_items.found_by_kind:
      in: query
      name: found_by_kind
      required: false
      schema:
        type: string
    rowFilter.found_items.found_by_phone:
      in: query
      name: found_by_phone
      required: false
      schema:
        type: string
    rowFilter.found_items.found_by_user_id:
      in: query
      name: found_by_user_id
      required: false
      schema:
        type: string
    rowFilter.found_items.lost_found_category_id:
      in: query
      name: lost_found_category_id
      required: false
      schema:
        type: string
    rowFilter.found_items.category:
      in: query
      name: category
      required: false
      schema:
        type: string
    rowFilter.found_items.item_description:
      in: query
      name: item_description
      required: false
      schema:
        type: string
    rowFilter.found_items.brand:
      in: query
      name: brand
      required: false
      schema:
        type: string
    rowFilter.found_items.colour:
      in: query
      name: colour
      required: false
      schema:
        type: string
    rowFilter.found_items.serial_number:
      in: query
      name: serial_number
      required: false
      schema:
        type: string
    rowFilter.found_items.distinguishing_marks:
      in: query
      name: distinguishing_marks
      required: false
      schema:
        type: string
    rowFilter.found_items.quantity:
      in: query
      name: quantity
      required: false
      schema:
        type: string
    rowFilter.found_items.estimated_value:
      in: query
      name: estimated_value
      required: false
      schema:
        type: string
    rowFilter.found_items.estimated_value_currency_id:
      in: query
      name: estimated_value_currency_id
      required: false
      schema:
        type: string
    rowFilter.found_items.is_valuable:
      in: query
      name: is_valuable
      required: false
      schema:
        type: string
    rowFilter.found_items.storage_location_id:
      in: query
      name: storage_location_id
      required: false
      schema:
        type: string
    rowFilter.found_items.storage_location_name:
      in: query
      name: storage_location_name
      required: false
      schema:
        type: string
    rowFilter.found_items.storage_detail:
      in: query
      name: storage_detail
      required: false
      schema:
        type: string
    rowFilter.found_items.stored_by_user_id:
      in: query
      name: stored_by_user_id
      required: false
      schema:
        type: string
    rowFilter.found_items.stored_by:
      in: query
      name: stored_by
      required: false
      schema:
        type: string
    rowFilter.found_items.hold_until:
      in: query
      name: hold_until
      required: false
      schema:
        type: string
    rowFilter.found_items.days_held:
      in: query
      name: days_held
      required: false
      schema:
        type: string
    rowFilter.found_items.hold_expired:
      in: query
      name: hold_expired
      required: false
      schema:
        type: string
    rowFilter.found_items.lost_item_report_id:
      in: query
      name: lost_item_report_id
      required: false
      schema:
        type: string
    rowFilter.found_items.lost_reference:
      in: query
      name: lost_reference
      required: false
      schema:
        type: string
    rowFilter.found_items.owner_name:
      in: query
      name: owner_name
      required: false
      schema:
        type: string
    rowFilter.found_items.owner_phone:
      in: query
      name: owner_phone
      required: false
      schema:
        type: string
    rowFilter.found_items.owner_email:
      in: query
      name: owner_email
      required: false
      schema:
        type: string
    rowFilter.found_items.matched_at:
      in: query
      name: matched_at
      required: false
      schema:
        type: string
    rowFilter.found_items.matched_by_user_id:
      in: query
      name: matched_by_user_id
      required: false
      schema:
        type: string
    rowFilter.found_items.match_notes:
      in: query
      name: match_notes
      required: false
      schema:
        type: string
    rowFilter.found_items.collected_by_name:
      in: query
      name: collected_by_name
      required: false
      schema:
        type: string
    rowFilter.found_items.collected_by_id_type:
      in: query
      name: collected_by_id_type
      required: false
      schema:
        type: string
    rowFilter.found_items.collected_by_id_number:
      in: query
      name: collected_by_id_number
      required: false
      schema:
        type: string
    rowFilter.found_items.collected_at:
      in: query
      name: collected_at
      required: false
      schema:
        type: string
    rowFilter.found_items.released_by_user_id:
      in: query
      name: released_by_user_id
      required: false
      schema:
        type: string
    rowFilter.found_items.released_by:
      in: query
      name: released_by
      required: false
      schema:
        type: string
    rowFilter.found_items.collection_notes:
      in: query
      name: collection_notes
      required: false
      schema:
        type: string
    rowFilter.found_items.disposed_at:
      in: query
      name: disposed_at
      required: false
      schema:
        type: string
    rowFilter.found_items.disposal_method:
      in: query
      name: disposal_method
      required: false
      schema:
        type: string
    rowFilter.found_items.disposal_notes:
      in: query
      name: disposal_notes
      required: false
      schema:
        type: string
    rowFilter.found_items.notes:
      in: query
      name: notes
      required: false
      schema:
        type: string
    rowFilter.found_items.standing:
      in: query
      name: standing
      required: false
      schema:
        type: string
    rowFilter.found_items.primary_image_file_id:
      in: query
      name: primary_image_file_id
      required: false
      schema:
        type: string
    rowFilter.found_items.row_version:
      in: query
      name: row_version
      required: false
      schema:
        type: string
    rowFilter.found_items.created_at:
      in: query
      name: created_at
      required: false
      schema:
        type: string
    rowFilter.found_items.updated_at:
      in: query
      name: updated_at
      required: false
      schema:
        type: string
    select:
      description: Filtering Columns
      in: query
      name: select
      required: false
      schema:
        type: string
    order:
      description: Ordering
      in: query
      name: order
      required: false
      schema:
        type: string
    range:
      description: Limiting and Pagination
      in: header
      name: Range
      required: false
      schema:
        type: string
    rangeUnit:
      description: Limiting and Pagination
      in: header
      name: Range-Unit
      required: false
      schema:
        default: items
        type: string
    offset:
      description: Limiting and Pagination
      in: query
      name: offset
      required: false
      schema:
        type: string
    limit:
      description: Limiting and Pagination
      in: query
      name: limit
      required: false
      schema:
        type: string
    preferCount:
      description: Preference
      in: header
      name: Prefer
      required: false
      schema:
        enum:
          - count=none
        type: string
  schemas:
    found_items:
      description: >-
        Property handed in, where it is kept, how long it has been there, and
        who took it away.
      properties:
        brand:
          format: character varying
          maxLength: 80
          type: string
        category:
          format: character varying
          maxLength: 150
          type: string
        collected_at:
          format: timestamp with time zone
          type: string
        collected_by_id_number:
          format: character varying
          maxLength: 60
          type: string
        collected_by_id_type:
          format: character varying
          maxLength: 30
          type: string
        collected_by_name:
          format: character varying
          maxLength: 150
          type: string
        collection_notes:
          format: text
          type: string
        colour:
          format: character varying
          maxLength: 40
          type: string
        created_at:
          format: timestamp with time zone
          type: string
        days_held:
          format: integer
          type: integer
        disposal_method:
          format: character varying
          maxLength: 30
          type: string
        disposal_notes:
          format: text
          type: string
        disposed_at:
          format: timestamp with time zone
          type: string
        distinguishing_marks:
          format: text
          type: string
        estimated_value:
          format: numeric
          type: number
        estimated_value_currency_id:
          format: uuid
          type: string
        found_at:
          format: timestamp with time zone
          type: string
        found_by_kind:
          format: character varying
          maxLength: 20
          type: string
        found_by_name:
          format: character varying
          maxLength: 150
          type: string
        found_by_phone:
          format: character varying
          maxLength: 40
          type: string
        found_by_user_id:
          description: >-
            Note:

            This is a Foreign Key to `my_profile.user_id`.<fk table='my_profile'
            column='user_id'/>
          format: uuid
          type: string
        found_location_detail:
          format: character varying
          maxLength: 200
          type: string
        found_location_id:
          description: >-
            Note:

            This is a Foreign Key to `location_settings.id`.<fk
            table='location_settings' column='id'/>
          format: uuid
          type: string
        found_location_name:
          format: character varying
          maxLength: 200
          type: string
        handed_in_at:
          format: timestamp with time zone
          type: string
        hold_expired:
          format: boolean
          type: boolean
        hold_until:
          format: date
          type: string
        id:
          description: |-
            Note:
            This is a Primary Key.<pk/>
          format: uuid
          type: string
        is_valuable:
          format: boolean
          type: boolean
        item_description:
          format: text
          type: string
        lost_found_category_id:
          description: >-
            Note:

            This is a Foreign Key to `lost_found_categories.id`.<fk
            table='lost_found_categories' column='id'/>
          format: uuid
          type: string
        lost_item_report_id:
          description: >-
            Note:

            This is a Foreign Key to `lost_item_reports.id`.<fk
            table='lost_item_reports' column='id'/>
          format: uuid
          type: string
        lost_reference:
          format: character varying
          maxLength: 40
          type: string
        match_notes:
          format: text
          type: string
        matched_at:
          format: timestamp with time zone
          type: string
        matched_by_user_id:
          description: >-
            Note:

            This is a Foreign Key to `my_profile.user_id`.<fk table='my_profile'
            column='user_id'/>
          format: uuid
          type: string
        notes:
          format: text
          type: string
        owner_email:
          format: character varying
          maxLength: 255
          type: string
        owner_name:
          format: character varying
          maxLength: 150
          type: string
        owner_phone:
          format: character varying
          maxLength: 40
          type: string
        primary_image_file_id:
          format: uuid
          type: string
        quantity:
          format: integer
          type: integer
        reference:
          format: character varying
          maxLength: 40
          type: string
        released_by:
          format: character varying
          maxLength: 200
          type: string
        released_by_user_id:
          description: >-
            Note:

            This is a Foreign Key to `my_profile.user_id`.<fk table='my_profile'
            column='user_id'/>
          format: uuid
          type: string
        row_version:
          format: bigint
          type: integer
        serial_number:
          format: character varying
          maxLength: 80
          type: string
        site_code:
          format: character varying
          maxLength: 50
          type: string
        site_id:
          description: >-
            Note:

            This is a Foreign Key to `site_settings.id`.<fk
            table='site_settings' column='id'/>
          format: uuid
          type: string
        site_name:
          format: character varying
          maxLength: 200
          type: string
        standing:
          format: text
          type: string
        status:
          format: character varying
          maxLength: 20
          type: string
        storage_detail:
          format: character varying
          maxLength: 200
          type: string
        storage_location_id:
          description: >-
            Note:

            This is a Foreign Key to `location_settings.id`.<fk
            table='location_settings' column='id'/>
          format: uuid
          type: string
        storage_location_name:
          format: character varying
          maxLength: 200
          type: string
        stored_by:
          format: character varying
          maxLength: 200
          type: string
        stored_by_user_id:
          description: >-
            Note:

            This is a Foreign Key to `my_profile.user_id`.<fk table='my_profile'
            column='user_id'/>
          format: uuid
          type: string
        updated_at:
          format: timestamp with time zone
          type: string
      type: object

````

## Related topics

- [Lost & Found](/work/lost-and-found.md)
- [Today and Work](/field/today-and-work.md)
- [Approval workflows](/config/workflows.md)
- [Statuses and transitions](/config/statuses.md)
- [Approvals](/work/approvals.md)