Get Products

Retrieve a list of products from your easycart store.

Request

GET /products

Query Parameters

Parameter	Type	Required	Default	Description
page	integer	No	1	Page number for pagination

Example Request

curl -X GET "https://cart.easy.tools/api/v1/products?page=1" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response

Success Response (200)

Returns a paginated list of products.

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "published",
      "name": "Premium Coffee Beans",
      "description": "High-quality arabica coffee beans from Colombia",
      "image_url": "https://example.com/images/coffee-beans.jpg",
      "checkout_url": "https://cart.easy.tools/checkout/550e8400-e29b-41d4-a716-446655440000",
      "currency": "usd"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "status": "draft",
      "name": "Organic Tea Selection",
      "description": null,
      "image_url": null,
      "checkout_url": "https://cart.easy.tools/checkout/550e8400-e29b-41d4-a716-446655440001",
      "currency": "eur"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 5
  }
}

Response Fields

Field	Type	Nullable	Description
id	string	No	Unique identifier for the product (UUID)
status	string	No	Product status (e.g., "published" or "draft")
name	string	No	Product name
description	string	Yes	Product description
image_url	string	Yes	URL to the product image
checkout_url	string	No	Direct checkout URL for the product
currency	string	No	ISO currency code (e.g., "usd", "eur")