Items API Documentation

Authentication

Secure your requests with an API key.

All API requests must include the API key in the header.

Header Name
x-api-key
Example Value
sample_api_key

Products API

GET /api/v1/products

Query Parameters

ParameterTypeDescriptionExample
pagenumberPage number (default: 1)?page=2
limitnumberItems per page (default: 10, max: 100)?limit=20
searchstringSearch name, description, tags?search=rudraksha
categorystringFilter by category?category=bracelets
min_pricenumberMin price filter?min_price=100
max_pricenumberMax price filter?max_price=5000
sortstringSort options: price_asc, price_desc, newest, oldest?sort=price_desc
in_stockbooleanFilter only in-stock items?in_stock=true

Response Example

{
  "meta": {
    "total": 50,
    "page": 1,
    "limit": 10,
    "totalPages": 5
  },
  "data": [
    {
      "product_id": "prod_001",
      "sku": "RUD-IND-02M",
      "basic_info": {
        "name": "2-Mukhi Rudraksh (Indian)",
        ...
      },
      ...
    }
  ]
}

Orders API (Coming Soon)

POST /api/v1/orders

Required Request Body

{
  "order_id": "ord_9f8e7d6c5b4a",
  "customer_id": "cus_12345xyz",
  "items": [
    {
      "product_id": "rud_2",
      "quantity": 1,
      ...
    }
  ],
  ...
}