Skip to main content
GET
/
api
/
v1
/
products
/
:id
Get Product
curl --request GET \
  --url https://api.launchmystore.io/api/v1/products/:id \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "id": "<string>",
    "title": "<string>",
    "handle": "<string>",
    "description": "<string>",
    "vendor": "<string>",
    "product_type": "<string>",
    "status": "<string>",
    "tags": [
      {}
    ],
    "variants": [
      {}
    ],
    "options": [
      {}
    ],
    "images": [
      {}
    ],
    "created_at": "<string>",
    "updated_at": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.launchmystore.io/llms.txt

Use this file to discover all available pages before exploring further.

Get Product

Returns a single product by its unique ID.

Request

curl -X GET "https://api.launchmystore.io/api/v1/products/prod_abc123" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Parameters

id
string
required
The unique product ID
fields
string
Comma-separated list of fields to include in the response

Response

success
boolean
Whether the request succeeded
data
object
The product object

Example Response

{
  "success": true,
  "data": {
    "id": "prod_abc123",
    "title": "Classic T-Shirt",
    "handle": "classic-t-shirt",
    "description": "<p>A comfortable cotton t-shirt perfect for everyday wear.</p>",
    "vendor": "MyBrand",
    "product_type": "Apparel",
    "status": "active",
    "tags": ["cotton", "casual", "summer"],
    "options": [
      {
        "id": "opt_1",
        "name": "Size",
        "values": ["Small", "Medium", "Large", "XL"]
      },
      {
        "id": "opt_2",
        "name": "Color",
        "values": ["Black", "White", "Navy"]
      }
    ],
    "variants": [
      {
        "id": "var_xyz789",
        "title": "Small / Black",
        "price": 2500,
        "compare_at_price": 3000,
        "sku": "TSHIRT-S-BLK",
        "barcode": "123456789012",
        "inventory_quantity": 50,
        "weight": 200,
        "weight_unit": "g",
        "option1": "Small",
        "option2": "Black",
        "requires_shipping": true,
        "taxable": true
      }
    ],
    "images": [
      {
        "id": "img_123",
        "src": "https://cdn.launchmystore.io/images/tshirt.jpg",
        "alt": "Classic T-Shirt in Black",
        "position": 1,
        "width": 1200,
        "height": 1600
      }
    ],
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-20T14:45:00Z"
  }
}

Error Codes

CodeDescription
UNAUTHORIZEDInvalid or missing access token
FORBIDDENApp doesn’t have read_products scope
NOT_FOUNDProduct with the specified ID does not exist