Get item details

Returns one item’s catalog details by your item_id.

GET /v2/product/{item_id}

Get item details

cURL

curl --request GET \
  --url https://app.getswipe.in/api/partner/v2/product/{item_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "success": true,
  "message": "Message",
  "error_code": "",
  "errors": {},
  "data": {
    "id": "ITEM123",
    "name": "Item Name",
    "quantity": 1,
    "unit_price": 100,
    "price_with_tax": 118,
    "item_type": "Product",
    "tax_rate": 18,
    "purchase_price_with_tax": 118,
    "description": "Item Description",
    "hsn_code": "1234",
    "unit": "kg",
    "cess_rate": 0,
    "cess_amount": 0,
    "barcode": "2273546838467",
    "category": "Electronics",
    "alternative_units": [
      {
        "alternative_unit": "g",
        "conversion_rate": 1000
      }
    ],
    "custom_columns": [
      {
        "label": "Custom Label",
        "value": "Custom Value"
      }
    ],
    "preferences": {
      "not_for_sale": false,
      "low_stock_alert": 0,
      "show_online": false,
      "discount_percent": 10
    },
    "visibility": 1
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is an API key from the API Integration section of your dashboard. Keys are scoped to the company they are generated in — for testing, add a separate test company and generate the key there, so requests never touch your real books.

Path Parameters

item_id · string · required

Item ID to be fetched

Response

200

application/json

Success

success · boolean

Success flag

Example:

true

message · string

Response message

Example:

"Message"

error_code · string

Error Code

Example:

""

errors · object

Errors

data · object

Show child attributes