> ## 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 Premiums Endpoint

> Premiums endpoint allows you to retrieve a list of premiums connected with active company. A GET request to this endpoint, along with the necessary authorization, returns a paginated list of premiums with details such as premium ID, options, creation/update timestamps, category, name, type, amount, and other relevant information.



## OpenAPI

````yaml get /catalogs/premiums/
openapi: 3.0.1
info:
  title: Trace Connect API
  version: v1
servers:
  - url: http://localhost:3000/connect/v1
security:
  - Bearer: []
paths:
  /catalogs/premiums/:
    get:
      tags:
        - catalogs
      operationId: catalogs_premiums_list
      parameters:
        - name: name
          in: query
          schema:
            type: string
        - name: updated_after
          in: query
          schema:
            type: number
        - 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
                  next:
                    type: string
                    format: uri
                    nullable: true
                  previous:
                    type: string
                    format: uri
                    nullable: true
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Premium'
components:
  schemas:
    Premium:
      required:
        - name
      type: object
      properties:
        id:
          type: string
        options:
          type: array
          items:
            $ref: '#/components/schemas/PremiumOptionSeriazer'
        updated_on:
          title: Updated On
          type: string
          format: date-time
          readOnly: true
        created_on:
          title: Updated On
          type: string
          format: date-time
          readOnly: true
        category:
          title: Premium Category
          type: string
          enum:
            - PAYOUT
            - TRANSACTION
        name:
          title: Premium Name
          maxLength: 100
          minLength: 1
          type: string
        type:
          title: Premium Type
          type: string
          enum:
            - PER_TRANSACTION
            - PER_KG
            - PER_UNIT_CURRENCY
            - PER_FARMER
        amount:
          title: Amount
          type: number
          nullable: true
        included:
          title: Included
          type: boolean
        dependant_on_card:
          title: Dependant on Card
          type: boolean
        applicable_activity:
          title: Applicable Activity
          type: string
          enum:
            - BUY
            - SELL
        calculation_type:
          title: Calculation Type
          type: string
          enum:
            - NORMAL
            - MANUAL
            - OPTIONS
        is_active:
          title: Is Active
          type: boolean
        creator:
          type: string
        updater:
          type: string
        owner:
          type: string
    PremiumOptionSeriazer:
      required:
        - amount
        - name
      type: object
      properties:
        id:
          type: string
        updated_on:
          title: Updated On
          type: string
          format: date-time
          readOnly: true
        created_on:
          title: Updated On
          type: string
          format: date-time
          readOnly: true
        name:
          title: Option Name
          maxLength: 25
          minLength: 1
          type: string
        amount:
          title: Amount
          type: number
        is_active:
          title: Is Active
          type: boolean
        creator:
          type: string
        updater:
          type: string
  securitySchemes:
    Bearer:
      type: apiKey
      name: Authorization
      in: header

````