---
title: "Get list of items"
method: GET
path: "/v1/product/list"
tags: ["Product"]
---

# Get list of items

`GET /v1/product/list`

## Request

- Base URL: `https://app.getswipe.in/api/partner`
- URL: `https://app.getswipe.in/api/partner/v1/product/list`
- Auth: HTTP bearer

**v1 is deprecated — use the v2 endpoint instead.** Lists the items in your catalog.

## Query parameters

- `num_records` string
- `page` integer
- `sort_by` 'name' | 'category' | 'quantity' | 'unit_price' | 'price_with_tax' | 'tax_rate' | 'created_at' | 'updated_at'
- `sort_order` 'asc' | 'desc'

## Response `200`

Item List fetched successfully

- ListItemsResponseV1
  - `success` boolean: Success flag
  - `items` ItemListV1[]
    - `id` string, required: Unique id for each item. If a new id is sent, a new Item with the below details will be automatically created. if existing Item id is sent the details will not override the original item details. They will be applicable only to the current invoice
    - `name` string, required: Name of the Product
    - `quantity` number, required: Current Quantity
    - `unit_price` number, required: Price per item without Tax
    - `tax_rate` number: Tax percentage for each item . Only valid tax rates are accepted
    - `price_with_tax` number, required: Price per item with Tax
    - `discount_percent` number: Default Discount Percent
    - `description` string: Item Description
    - `hsn_code` string: HSN Code
    - `item_type` string, required: Product or Service enum
    - `unit` string: item quantity unit
    - `category` string: Category
    - `swipe_id` string: Swipe ID assigned to the item
  - `total_records` integer: Total Records available

## Other responses

- `400`: Error in fetching Item List
- `401`: Unauthorized
- `500`: Internal Server Error

## Changes

- **2026-11-03** `0bcdbc62187b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getswipe/apis/swipeapi/changes/v1/product/list/get.md)

---

[API](https://skmtc.dev/getswipe/apis/swipeapi.md) - [All operations](https://skmtc.dev/getswipe/apis/swipeapi/llms.txt) - [OpenAPI document](https://skmtc.dev/getswipe/apis/swipeapi/revisions/0bcdbc62187b?raw)