GET/v1/images/{id}
Fetch an image's record: status, url, size
PARAMETERS
- idpath · stringREQUIRED
- The image ide.g. img_7hk2mq9ztbw4e6nrcxpd
REQUEST
curl "https://api.imageapis.com/v1/images/img_7hk2mq9ztbw4e6nrcxpd" \ -H "X-API-Key: YOUR_KEY"
import requests
r = requests.get("https://api.imageapis.com/v1/images/img_7hk2mq9ztbw4e6nrcxpd", headers={"X-API-Key": "YOUR_KEY"})
print(r.status_code, r.headers.get("X-Gw-Remaining"))
print(r.json())
const r = await fetch("https://api.imageapis.com/v1/images/img_7hk2mq9ztbw4e6nrcxpd", {
headers: { "X-API-Key": "YOUR_KEY" }
});
console.log(r.status, r.headers.get("X-Gw-Remaining"));
console.log(await r.json());
RESPONSE
200OK
{
"id": "img_7hk2mq9ztbw4e6nrcxpd",
"object": "image",
"status": "completed",
"url": "https://img.imageapis.com/i/img_7hk2mq9ztbw4e6nrcxpd.png",
"format": "png",
"width": 1200,
"height": 630,
"scale": 1,
"template": "tpl_4nq8vzk2hdyw7bxme3rc",
"bytes": 48213,
"units": 1,
"created": "2026-10-10T18:04:11Z",
"completed": "2026-10-10T18:04:12Z",
"expires": "2026-11-09T18:04:11Z"
}
401Missing or invalid API key (from the gateway)
404No such template or record on this account
{
"error": "string",
"message": "string",
"param": "string"
}