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

# List all products

> Retrieve a paginated list of all products in the authenticated store.   Use this endpoint to fetch existing products, filter them, or synchronize them with external services.

## TypeScript SDK Example

```ts theme={null}
import Genuka from "genuka-api";
const genuka = Genuka.initialize({ id: companyId });
await genuka.products.list({ page: 1, limit: 20 });
```


## OpenAPI

````yaml GET /2023-11/admin/products
openapi: 3.0.3
info:
  title: Genuka V2 - API
  version: 1.0.0
  contact: {}
servers:
  - url: https://api-staging.genuka.com
  - url: https://api.genuka.com
security:
  - bearerAuth: []
tags:
  - name: Public Routes
  - name: Pages
  - name: Collections
  - name: Shops
  - name: Products
  - name: Articles
  - name: Discounts
  - name: Blogs
  - name: Company
  - name: Review
    description: |-
      ``` json
      {
      "title": "",
      "quantity": "",
      "product_variant": "",
      "date": "",
      "company_id": "",
      "shops": []
      }

       ```
  - name: Private Routes
  - name: Authentication
  - name: Apps
  - name: Accounting
  - name: Addresses
  - name: Customer
  - name: Analytics
  - name: Articles1
  - name: Availabilities
  - name: API Keys
  - name: Orders
  - name: Bills
  - name: Blogs1
  - name: Calendar Events
  - name: Collections1
  - name: Company1
  - name: Customers
  - name: Deliveries
    description: |-
      ``` json
      {
      "title": "",
      "quantity": "",
      "product_variant": "",
      "date": "",
      "company_id": "",
      "shops": []
      }

       ```
  - name: Discount
  - name: Domains
    description: |-
      ``` json
      {
      "domain": "",
      "company_id": ""
      }

       ```
  - name: Analytics1
  - name: Orders1
  - name: Payments
  - name: Pages1
  - name: Production
  - name: Bill of Materials
  - name: Payments1
  - name: Payments Methods
  - name: Workflows
  - name: New Folder
  - name: Wallet
  - name: Marketing
  - name: Campaigns
  - name: Templates
  - name: Products1
  - name: Product Variants
  - name: Analytics12
  - name: Services
    description: >-
      Services are "Products" that have a duration in minutes, a buffer time and
      a list of users able to provide the service.
  - name: SupplierProducts
  - name: Shops1
    description: >-
      Shops are sort of subsidiary of companies. A Company can have many Shops.
      Each shop can have 0 or more .  
        
      But all of them are properties of a Company.
  - name: Warehouses
    description: >-
      Warehouses are places where stocks are placed.


      Shop which are physical or virtual point of sales can be attached to one
      or many warehouses to take their products.
  - name: Stocks
    description: |-
      ``` json
      {
      "title": "",
      "quantity": "",
      "product_variant": "",
      "date": "",
      "company_id": "",
      "shops": []
      }

       ```
  - name: Review1
    description: |-
      ``` json
      {
      "title": "",
      "quantity": "",
      "product_variant": "",
      "date": "",
      "company_id": "",
      "shops": []
      }

       ```
  - name: ReviewCriterion
    description: |-
      ``` json
      {
      "title": "",
      "quantity": "",
      "product_variant": "",
      "date": "",
      "company_id": "",
      "shops": []
      }

       ```
  - name: StockMovements
    description: |-
      ``` json
      {
      "title": "",
      "quantity": "",
      "product_variant": "",
      "date": "",
      "company_id": "",
      "shops": []
      }

       ```
  - name: Suppliers
  - name: Treasury Accounts
    description: Comptes de trésorerie
  - name: Users
  - name: Wrapped
  - name: Returns
  - name: Webhooks
  - name: Customer Routes
  - name: Authentication1
  - name: Addresses1
  - name: Orders12
  - name: Payments12
  - name: Review12
    description: |-
      ``` json
      {
      "title": "",
      "quantity": "",
      "product_variant": "",
      "date": "",
      "company_id": "",
      "shops": []
      }

       ```
  - name: Developer Routes
  - name: Authentication12
  - name: Apps1
  - name: Apps Shortcut
  - name: Products12
    description: Developer can access a company product through its app
paths:
  /2023-11/admin/products:
    get:
      tags:
        - Developer Routes
        - Products12
      summary: List
      description: List
      operationId: list19
      parameters:
        - name: page
          in: query
          schema:
            type: string
            example: '1'
        - name: per_page
          in: query
          schema:
            type: string
            example: '10'
        - name: filter[type]
          in: query
          schema:
            type: string
            example: services
        - name: sort
          in: query
          schema:
            type: string
            example: title
        - name: include
          in: query
          schema:
            type: string
            example: shops
        - name: anonymous
          in: query
          schema:
            type: string
            example: 'false'
        - name: locale
          in: query
          schema:
            type: string
            example: en
        - name: x-company
          in: header
          schema:
            type: string
            example: '{{companyId}}'
        - name: filter%5Bactive%5D
          in: query
          schema:
            type: string
            example: 'false'
        - name: simple_paginate
          in: query
          schema:
            type: string
            example: 'true'
        - name: filter[published]
          in: query
          schema:
            type: string
            example: '0'
        - name: cypress_test
          in: query
          schema:
            type: string
            example: 'true'
        - name: deleted_at
          in: query
          schema:
            type: string
      requestBody:
        content:
          application/json:
            examples:
              Deleted:
                value: ''
              List:
                value: ''
      responses:
        '200':
          description: 200 / 200 OK
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-cache, private
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Thu, 09 Oct 2025 13:09:34 GMT
            Server:
              schema:
                type: string
                example: nginx/1.18.0 (Ubuntu)
            Transfer-Encoding:
              schema:
                type: string
                example: chunked
            Vary:
              schema:
                type: string
                example: Origin
            X-RateLimit-Limit:
              schema:
                type: string
                example: '6000'
            X-RateLimit-Remaining:
              schema:
                type: string
                example: '5999'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items: {}
                    example: []
                  links:
                    type: object
                    properties:
                      first:
                        type: string
                        example: http://genuka-api.test/2023-11/admin/products?page=1
                      last:
                        type: string
                        nullable: true
                        example: http://genuka-api.test/2023-11/admin/products?page=1
                      next:
                        type: string
                        nullable: true
                        example: null
                      prev:
                        nullable: true
                        example: null
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: number
                        example: 1
                      current_page_url:
                        type: string
                        example: http://genuka-api.test/2023-11/admin/products?page=1
                      from:
                        type: number
                        nullable: true
                        example: null
                      last_page:
                        type: number
                        example: 1
                      links:
                        type: array
                        items:
                          type: object
                          properties:
                            active:
                              type: boolean
                              example: false
                            label:
                              type: string
                              example: '&laquo; Previous'
                            page:
                              type: number
                              nullable: true
                              example: null
                            url:
                              type: string
                              nullable: true
                              example: null
                        example:
                          - active: false
                            label: '&laquo; Previous'
                            page: null
                            url: null
                          - active: true
                            label: '1'
                            page: 1
                            url: >-
                              http://genuka-api.test/2023-11/admin/products?page=1
                          - active: false
                            label: Next &raquo;
                            page: null
                            url: null
                      path:
                        type: string
                        example: http://genuka-api.test/2023-11/admin/products
                      per_page:
                        example: 10
                        anyOf:
                          - type: number
                            example: 10
                          - type: string
                            example: '1'
                      to:
                        type: number
                        nullable: true
                        example: null
                      total:
                        type: number
                        example: 0
              examples:
                '200':
                  value:
                    data: []
                    links:
                      first: http://genuka-api.test/2023-11/admin/products?page=1
                      last: http://genuka-api.test/2023-11/admin/products?page=1
                      next: null
                      prev: null
                    meta:
                      current_page: 1
                      from: null
                      last_page: 1
                      links:
                        - active: false
                          label: '&laquo; Previous'
                          page: null
                          url: null
                        - active: true
                          label: '1'
                          page: 1
                          url: http://genuka-api.test/2023-11/admin/products?page=1
                        - active: false
                          label: Next &raquo;
                          page: null
                          url: null
                      path: http://genuka-api.test/2023-11/admin/products
                      per_page: 10
                      to: null
                      total: 0
                200 OK:
                  value:
                    data:
                      - buffer_minutes: 0
                        company_id: 01k7464hqksr4f99rp3ff7x2jz
                        compare_at_price: null
                        content: null
                        created_at: '2025-10-09T09:57:33.000000Z'
                        deleted_at: null
                        deposit: null
                        duration_minutes: 0
                        first_variant:
                          barcode: '456340560'
                          base_title: Default Title
                          buffer_minutes: 0
                          compare_at_price: null
                          composite_stocks: []
                          created_at: '2025-10-09T09:57:33.000000Z'
                          deleted_at: null
                          deposit: null
                          duration_minutes: 0
                          estimated_quantity: null
                          estimated_quantity_by_warehouse: []
                          follow_stock: 0
                          id: 01k746f3dykkdsyb391ajy75pp
                          image_id: null
                          metadata: null
                          min_order_quantity: 1
                          options:
                            - 0
                          position: 1
                          price: 6500
                          product_id: 01k746f3cqa2wd5w33w9c879cx
                          professionals: []
                          service:
                            buffer_minutes: 0
                            created_at: '2025-10-09T09:57:33.000000Z'
                            deleted_at: null
                            deposit: null
                            duration_minutes: 0
                            id: 01k746f3f0vav49qtbx9kx26bz
                            metadata: null
                            product_variant_id: 01k746f3dykkdsyb391ajy75pp
                            professionals: []
                            updated_at: '2025-10-09T09:57:33.000000Z'
                          service_id: 01k746f3f0vav49qtbx9kx26bz
                          sku: le paquet
                          supplierproduct: null
                          taxable: 1
                          title: Default Title
                          updated_at: '2025-10-09T09:57:33.000000Z'
                          whatsapp_product_id: null
                        follow_stock: false
                        handle: arachide-blanc-du-ndole
                        has_variants: true
                        id: 01k746f3cqa2wd5w33w9c879cx
                        is_shippable: 1
                        is_taxable: 1
                        medias: []
                        metadata:
                          image_ready: false
                        min_price: 6500
                        professionals: []
                        published: 1
                        remaining_stocks: null
                        shops:
                          - address: null
                            company_id: 01k7464hqksr4f99rp3ff7x2jz
                            created_at: '2025-10-09T09:51:50.000000Z'
                            currency_code: XAF
                            currency_name: null
                            deleted_at: null
                            description: This is the first shop
                            domains: []
                            id: 01k7464m19emgj0q6v0v95wp88
                            logo: null
                            logoUrl: ''
                            metadata: null
                            name: Pet Clinic Shop
                            pivot:
                              product_id: 01k746f3cqa2wd5w33w9c879cx
                              shop_id: 01k7464m19emgj0q6v0v95wp88
                            slug: pet-clinic-shop
                            updated_at: '2025-10-09T09:51:50.000000Z'
                            warehouses:
                              - company_id: 01k7464hqksr4f99rp3ff7x2jz
                                created_at: '2025-10-09T09:51:50.000000Z'
                                deleted_at: null
                                description: This is the first warehouse
                                id: 01k7464m1pykz767t3rv9d4q76
                                metadata: null
                                name: Pet Clinic Warehouse
                                pivot:
                                  metadata: null
                                  shop_id: 01k7464m19emgj0q6v0v95wp88
                                  warehouse_id: 01k7464m1pykz767t3rv9d4q76
                                updated_at: '2025-10-09T09:51:50.000000Z'
                        supplier_id: null
                        tags:
                          - company_id: 01k7464hqksr4f99rp3ff7x2jz
                            created_at: '2025-10-09T09:57:33.000000Z'
                            id: 01k746f3hn5q8z1kw9m69v1h6a
                            name: TAG NOUVEAU 1
                            pivot:
                              created_at: '2025-10-09T09:57:33.000000Z'
                              tag_id: 01k746f3hn5q8z1kw9m69v1h6a
                              taggable_id: 01k746f3cqa2wd5w33w9c879cx
                              taggable_type: App\Models\Product
                              updated_at: '2025-10-09T09:57:33.000000Z'
                            updated_at: '2025-10-09T09:57:33.000000Z'
                          - company_id: 01k7464hqksr4f99rp3ff7x2jz
                            created_at: '2025-10-09T09:57:33.000000Z'
                            id: 01k746f3jd4tc7z3jkdf5nm4bw
                            name: TAG NOUVEAU 2
                            pivot:
                              created_at: '2025-10-09T09:57:33.000000Z'
                              tag_id: 01k746f3jd4tc7z3jkdf5nm4bw
                              taggable_id: 01k746f3cqa2wd5w33w9c879cx
                              taggable_type: App\Models\Product
                              updated_at: '2025-10-09T09:57:33.000000Z'
                            updated_at: '2025-10-09T09:57:33.000000Z'
                        title: Arachide blanc du ndole
                        type: physical_goods
                        updated_at: '2025-10-09T09:57:33.000000Z'
                        variants_count: 1
                        vendor: null
                    links:
                      first: http://genuka-api.test/2023-11/admin/products?page=1
                      last: null
                      next: http://genuka-api.test/2023-11/admin/products?page=2
                      prev: null
                    meta:
                      current_page: 1
                      current_page_url: http://genuka-api.test/2023-11/admin/products?page=1
                      from: 1
                      path: http://genuka-api.test/2023-11/admin/products
                      per_page: '1'
                      to: 1
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````