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

# List Products Endpoint

> Products endpoint allows you to retrieve a list of products connected with the active company. A GET request to this endpoint, along with the necessary authorization, returns a paginated list of products with details such as product ID, creation/update timestamps, name, and other relevant information.



## OpenAPI

````yaml get /catalogs/products/
openapi: 3.0.1
info:
  title: Trace Connect API
  version: v1
servers:
  - url: http://localhost:3000/connect/v1
security:
  - Bearer: []
paths:
  /catalogs/products/:
    get:
      tags:
        - catalogs
      operationId: catalogs_products_list
      parameters:
        - name: name
          in: query
          schema:
            type: string
          description: |
            Filter products by name.
        - name: description
          in: query
          schema:
            type: string
          description: |
            Filter products by description.
        - name: updated_after
          in: query
          schema:
            type: number
          description: |
            Filter products updated after a specified timestamp.
        - name: limit
          in: query
          description: |
            Number of results to return per page.
          schema:
            type: integer
        - name: offset
          in: query
          description: |
            The initial index from which to return the results.
          schema:
            type: integer
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                required:
                  - count
                  - results
                type: object
                properties:
                  count:
                    type: integer
                    description: The total count of products in the response.
                  next:
                    type: string
                    format: uri
                    nullable: true
                    description: The URI for the next page of results, if available.
                  previous:
                    type: string
                    format: uri
                    nullable: true
                    description: The URI for the previous page of results, if available.
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Product'
                    description: >-
                      An array containing details of products returned in the
                      response.
components:
  schemas:
    Product:
      required:
        - name
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the product.
        premiums:
          title: Premiums
          type: string
          readOnly: true
          description: Premiums associated with the product.
        is_active:
          title: Is active
          type: string
          readOnly: true
          description: Indicates whether the product is currently active.
        updated_on:
          title: Updated On
          type: string
          format: date-time
          readOnly: true
          description: Date and time when the product information was last updated.
        created_on:
          title: Created On
          type: string
          format: date-time
          readOnly: true
          description: Date and time when the product was created.
        name:
          title: Product Name
          maxLength: 500
          minLength: 1
          type: string
          description: Name of the product.
        description:
          title: Product Description
          maxLength: 500
          type: string
          nullable: true
          description: Description of the product.
        image:
          title: Product Image
          type: string
          format: uri
          nullable: true
          readOnly: true
          description: URL to the image or photo of the product.
        creator:
          type: string
          description: Identifier of the user who created the product.
        updater:
          type: string
          description: Identifier of the user who last updated the product.
  securitySchemes:
    Bearer:
      type: apiKey
      name: Authorization
      in: header

````