List product images
Scope: inventory:products.read https://api.alladdin.com/api/v2/products/{productId}/images
Retrieves the list of all images associated with a product.
Each image includes its URL, available sizes (original, large, medium, small, thumbnail), position in the gallery, and description.
Parameters
Path parameters
productId string required
Product ID (24-char hex ObjectId)
Request
import requests
url = "https://api.alladdin.com/api/v2/products/{productId}/images"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Responses
Response
{
"items": [
{
"id": "507f1f77bcf86cd799439011",
"position": 1,
"description": "string",
"url": "string",
"sizes": {
"original": {
"url": "...",
"width": "...",
"height": "..."
},
"large": {
"url": "...",
"width": "...",
"height": "..."
},
"medium": {
"url": "...",
"width": "...",
"height": "..."
},
"small": {
"url": "...",
"width": "...",
"height": "..."
},
"thumbnail": {
"url": "...",
"width": "...",
"height": "..."
}
}
}
]
}Success responses
200 List of product images application/json object items[] object[]
Array of product images
id string required
Unique identifier of the image
position integer required
Position of the image in the product gallery (1-indexed)
description string | null required
Alt text or description of the image
url string | null required
Primary image URL (original size or raw URL)
sizes object required
Available image sizes with URLs and dimensions
Error responses
401 Invalid or missing API key application/json 403 Insufficient permissions application/json 404 Product not found application/json 429 Rate limit exceeded application/json