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

# List marketplace packages



## OpenAPI

````yaml /api-reference/openapi.yaml get /api/v1/marketplace/packages
openapi: 3.0.1
info:
  title: API V1
  version: v1
servers:
  - url: https://{defaultHost}
    variables:
      defaultHost:
        default: api.kenekt.com.au
security: []
tags:
  - name: Stock
    description: >-
      This agency's own stock: packages as JSON, the subset published to your
      website, and the same list exported as CSV or Excel.
  - name: Marketplace
    description: Packages listed on the Kenekt marketplace.
  - name: Brochures
    description: The PDF brochure for a package, by Bearer key or signed link.
paths:
  /api/v1/marketplace/packages:
    get:
      tags:
        - Marketplace
      summary: List marketplace packages
      parameters:
        - name: Authorization
          in: header
          required: true
          description: 'Token authentication using format: Bearer <api_key>'
          example: Bearer abc123def456
          schema:
            type: string
        - $ref: '#/components/parameters/PackageLimit'
        - $ref: '#/components/parameters/PackageStates'
        - $ref: '#/components/parameters/PackageRegions'
        - $ref: '#/components/parameters/PackageSuburbs'
        - $ref: '#/components/parameters/PackageBedrooms'
        - $ref: '#/components/parameters/PackageBuildingTypes'
        - $ref: '#/components/parameters/PackageTags'
        - $ref: '#/components/parameters/PackageSuppliers'
        - $ref: '#/components/parameters/PackageStatuses'
        - $ref: '#/components/parameters/PackageFromPrice'
        - $ref: '#/components/parameters/PackageToPrice'
        - $ref: '#/components/parameters/PackageSort'
        - $ref: '#/components/parameters/PackagePage'
      responses:
        '200':
          description: successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PackagesResponse'
        '401':
          description: unauthorized
      security:
        - bearer_auth: []
components:
  parameters:
    PackageLimit:
      name: limit
      in: query
      schema:
        type: integer
        minimum: 1
        maximum: 5000
        default: 40
      required: false
      description: Number of packages per page
    PackageStates:
      name: states
      in: query
      schema:
        type: string
        example: NSW,QLD
      required: false
      description: Comma-separated Australian states (also accepts singular 'state' param)
    PackageRegions:
      name: regions
      in: query
      schema:
        type: string
        example: Western Sydney
      required: false
      description: Comma-separated region names
    PackageSuburbs:
      name: suburbs
      in: query
      schema:
        type: string
        example: Marsden Park
      required: false
      description: Comma-separated suburb names
    PackageBedrooms:
      name: bedrooms
      in: query
      schema:
        type: string
        example: 3,4
      required: false
      description: Comma-separated bedroom counts
    PackageBuildingTypes:
      name: building_types
      in: query
      schema:
        type: string
        example: House,Townhouse
      required: false
      description: Comma-separated property types
    PackageTags:
      name: tags
      in: query
      schema:
        type: string
        example: Premium,Turnkey
      required: false
      description: Comma-separated category or contract type tags
    PackageSuppliers:
      name: suppliers
      in: query
      schema:
        type: string
      required: false
      description: Comma-separated supplier names
    PackageStatuses:
      name: statuses
      in: query
      schema:
        type: string
        example: available
      required: false
      description: Comma-separated build statuses
    PackageFromPrice:
      name: from_price
      in: query
      schema:
        type: integer
        example: 500000
      required: false
      description: Minimum package price
    PackageToPrice:
      name: to_price
      in: query
      schema:
        type: integer
        example: 800000
      required: false
      description: Maximum package price
    PackageSort:
      name: sort
      in: query
      schema:
        type: string
        enum:
          - price_asc
          - price_desc
          - listed_asc
          - listed_desc
          - verified_asc
          - verified_desc
      required: false
      description: Sort order (defaults to listed_desc)
    PackagePage:
      name: page
      in: query
      schema:
        type: integer
        minimum: 0
        default: 0
      required: false
      description: Page number (0-indexed)
  schemas:
    PackagesResponse:
      type: object
      required:
        - data
        - meta
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Package'
        meta:
          type: object
          properties:
            total_count:
              type: integer
            page:
              type: integer
            per_page:
              type: integer
            total_pages:
              type: integer
        facets:
          type: object
          description: Available filter values with counts for building filter UI
          properties:
            states:
              type: object
              additionalProperties:
                type: integer
              example:
                NSW: 120
                QLD: 85
            regions:
              type: object
              additionalProperties:
                type: integer
            property_types:
              type: object
              additionalProperties:
                type: integer
            categories:
              type: object
              additionalProperties:
                type: integer
            contract_types:
              type: object
              additionalProperties:
                type: integer
            bedrooms:
              type: object
              additionalProperties:
                type: integer
            land_reg_dates:
              type: object
              additionalProperties:
                type: integer
            suppliers:
              type: object
              additionalProperties:
                type: integer
            statuses:
              type: object
              additionalProperties:
                type: integer
    Package:
      type: object
      required:
        - id
        - type
        - attributes
      properties:
        id:
          type: string
        type:
          type: string
        attributes:
          type: object
          required:
            - details
          properties:
            details:
              type: object
              required:
                - address
                - status
                - floor_area
                - contract_pricing
              properties:
                id:
                  type: string
                  description: Unique package identifier (public_uid)
                unit_number:
                  type: string
                  nullable: true
                street_number:
                  type: string
                  nullable: true
                street_address:
                  type: string
                suburb:
                  type: string
                state:
                  type: string
                postcode:
                  type: string
                region:
                  type: string
                  nullable: true
                address:
                  type: string
                full_address:
                  type: string
                status:
                  type: string
                property_type:
                  type: string
                  nullable: true
                floor_area:
                  type: string
                design:
                  type: string
                  nullable: true
                facade:
                  type: string
                  nullable: true
                contract_type:
                  type: string
                  nullable: true
                contract_pricing:
                  type: string
                  nullable: true
                bedrooms:
                  type: string
                  nullable: true
                living_spaces:
                  type: string
                  nullable: true
                bathrooms:
                  type: string
                  nullable: true
                garages:
                  type: string
                  nullable: true
                package_price:
                  type: string
                land_price:
                  type: string
                  nullable: true
                lot_size:
                  type: string
                  nullable: true
                land_width:
                  type: number
                  nullable: true
                land_length:
                  type: number
                  nullable: true
                land_registration_date:
                  type: string
                  nullable: true
                estimated_rental:
                  type: string
                  nullable: true
                estimated_yield:
                  type: string
                  nullable: true
                commission_rate:
                  type: string
                  nullable: true
                tags:
                  type: array
                  items:
                    type: string
                inclusions:
                  type: array
                  items:
                    type: string
                building_type_in_location:
                  type: string
                project_title:
                  type: string
                  nullable: true
                project_description:
                  type: string
                  nullable: true
                created_at:
                  type: string
                  format: date-time
                verified_at:
                  type: string
                  format: date-time
                  nullable: true
                updated_at:
                  type: string
                  format: date-time
                marketing_images:
                  type: array
                  items:
                    type: object
                    properties:
                      url:
                        type: string
                    required:
                      - url
                floor_plan_images:
                  type: array
                  items:
                    type: object
                    properties:
                      url:
                        type: string
                    required:
                      - url
                brochure_url:
                  type: string
                  nullable: true
                  format: uri
                  description: Signed URL for PDF brochure download
  securitySchemes:
    bearer_auth:
      type: http
      scheme: bearer
      bearerFormat: Token

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.