Get Product

Retrieve a specific product from your easycart store.

Request

GET /products/{id}

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Product UUID

Example Request

curl -X GET "https://cart.easy.tools/api/v1/products/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response

Success Response (200)

Returns a single product with its variants.

{
  "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",
  "variants": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "type": "one_time",
      "recurring_options": null,
      "name": "250g Package",
      "amount": 1999
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440003",
      "type": "recurring",
      "recurring_options": {
        "interval": "monthly",
        "interval_count": 1
      },
      "name": "Monthly Subscription - 250g",
      "amount": 1799
    }
  ]
}

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")
variants	array	No	List of product variants

Error Responses

Product Not Found (404)

{
  "message": "Product with ID <UUID> not found"
}