comecerodocs
Images

Get an image

GET
/images/{image_id}

Returns one image. Secret and trusted tokens may call it.

Authorization

headerAuthorizationBearer <token>

A secret, trusted or limited token. See Authentication.

Path Parameters

image_id*string

The image id.

Query Parameters

show?string

Comma-separated fields to return; all others are left out. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.

hide?string

Comma-separated fields to leave out of the response. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.

formatted?boolean

When true, the object also has a formatted child with amounts and dates as display text in the shopper's language and currency (for example $19.99 or November 7, 2026). The default is false. See Localized formatting.

Defaultfalse

Response Body

The image.

application/json
  1. response

An image you uploaded, such as a product picture. Comecero stores the original and four resized copies on its CDN.

object*"image"

The object type. Always image.

Value in"image"
url*string

The URL of this image in the API.

Formaturi
image_id*string

The id of the image.

date_created*string

When the image was uploaded.

Formatdate-time
date_modified*string

When the image was last changed.

Formatdate-time
test*boolean

True for a test-mode image.

account_id*string

The account the image belongs to.

link*string

The CDN link to the image as uploaded.

Formaturi
link_small*string

The CDN link to the small copy.

Formaturi
link_medium*string

The CDN link to the medium copy.

Formaturi
link_large*string

The CDN link to the large copy.

Formaturi
link_square*string

The CDN link to a square copy, for thumbnails.

Formaturi
filename*string

The file name, cleaned of characters that are not safe in a URL.

formatted?

Present only when you send formatted=true.

Example Request
curl -X GET 'https://api.comecero.com/api/v1/images/string'
Example Response
{  "object": "image",  "url": "https://api.comecero.com/api/v1/images/0099844605810ImLAMbo73",  "image_id": "0099844605810ImLAMbo73",  "date_created": "2026-11-02T14:36:45Z",  "date_modified": "2026-11-02T14:36:45Z",  "test": true,  "account_id": "AB1234",  "link": "https://cdn.comecero.net/AB1234/0099844605810ImLAMbo73/widget.png",  "link_small": "https://cdn.comecero.net/AB1234/0099844605810ImLAMbo73/sm_widget.png",  "link_medium": "https://cdn.comecero.net/AB1234/0099844605810ImLAMbo73/md_widget.png",  "link_large": "https://cdn.comecero.net/AB1234/0099844605810ImLAMbo73/lg_widget.png",  "link_square": "https://cdn.comecero.net/AB1234/0099844605810ImLAMbo73/sq_widget.png",  "filename": "widget.png"}

Upload an image POST

Uploads an image and makes small, medium, large and square copies of it on the CDN. The body must be `multipart/form-data` with the image in a part named `file`; a JSON body is refused with `400`. There is no way to upload an image from a URL. Use the `image_id` in a product's `image_ids`. Images cannot be changed after upload; upload a new one instead. Secret and trusted tokens may call it.

Delete an image DELETE

Deletes an image and its copies from the CDN for good. Products that list it in `image_ids` keep the id, but it no longer appears in their `images`. Secret and trusted tokens may call it.