Images

Endpoints in this collection return images associated with a product.

List Product Images

get

Returns a list of images uploaded by the Brand Owner or Wholesaler. The response includes urls of different size images if available from the system.

Authorizations

default

AuthorizationstringRequired

You can retrieve your token by visiting your dashboard and clicking Manage API tokens.

Path parameters

productstringRequired

The Erudus ID of the product.

Example: 7bc42964412a4566b3daa77bd6daf275

Query parameters

wholesalerintegerOptional

Show images for wholesaler (results will include brand owner and wholesaler's images).

Example: 2

filter[wholesaler]integerOptional

Filter images by wholesaler.

Example: 2

filter[type]integerOptional

Filter images by Image Type ID.

Example: 2

sortintegerOptional

Sort images by field.

Example: 0

Responses

200Success

application/json

pageintegerOptionalExample: 1

per pageintegerOptionalExample: 20

pagesintegerOptionalExample: 1

totalintegerOptionalExample: 1

get

/v2/images/{product}

HTTPcURLJavaScriptPython

GET /v2/images/{product} HTTP/1.1
Host: api.erudus.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200Success

{
  "page": 1,
  "per page": 20,
  "pages": 1,
  "total": 1,
  "data": [
    {
      "id": "fd1994e221c14a81873f0be3c9f1ce0a",
      "owner_id": 1234,
      "owner_type": "Manufacturer",
      "description": "Butter Shortbread biscuits",
      "type": {
        "id": 2,
        "name": "P2",
        "description": "Product pack shot (front)"
      },
      "width": 1612,
      "height": 1140,
      "created_at": "2022-01-20T15:07:33.000000Z",
      "updated_at": "2024-01-08T10:22:21.000000Z",
      "status": "published",
      "mime": "image/png",
      "url_original": "https://erudus-two-production.s3.eu-west-1.amazonaws.com/images/fd1994e221c14a81873f0be3c9f1ce0a/fd1994e221c14a81873f0be3c9f1ce0a.png",
      "url": "https://erudus-two-production.s3.eu-west-1.amazonaws.com/images/fd1994e221c14a81873f0be3c9f1ce0a/s/fd1994e221c14a81873f0be3c9f1ce0a.png",
      "url_medium": "https://erudus-two-production.s3.eu-west-1.amazonaws.com/images/fd1994e221c14a81873f0be3c9f1ce0a/m/fd1994e221c14a81873f0be3c9f1ce0a.png",
      "url_large": null
    }
  ]
}

Get Product Feature Image

get

Returns the feature image for the product. This is set by the Brand Owner. The response includes urls of different size images if available from the system.

Authorizations

default

AuthorizationstringRequired

You can retrieve your token by visiting your dashboard and clicking Manage API tokens.

Path parameters

productstringRequired

The Erudus ID of the product.

Example: 7bc42964412a4566b3daa77bd6daf275

Query parameters

wholesalerintegerOptional

Show images for wholesaler (includes brand and wholesaler's images).

Example: 2

Responses

200Success

application/json

get

/v2/images/{product}/feature

HTTPcURLJavaScriptPython

GET /v2/images/{product}/feature HTTP/1.1
Host: api.erudus.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200Success

{
  "data": {
    "id": "ef30bea5e1454b30b4a858b524c621a8",
    "owner_id": 1234,
    "owner_type": "Manufacturer",
    "description": "Pineapple Slices in Juice Can 432g",
    "type": {
      "id": 2,
      "name": "P2",
      "description": "Product pack shot (front)"
    },
    "width": 2000,
    "height": 2308,
    "created_at": "2025-09-09T13:44:46.000000Z",
    "updated_at": "2025-09-09T13:51:30.000000Z",
    "status": "published",
    "mime": "image/png",
    "url_original": "https://erudus-two-production.s3.eu-west-1.amazonaws.com/images/ef30bea5e1454b30b4a858b524c621a8/ef30bea5e1454b30b4a858b524c621a8.png",
    "url": "https://erudus-two-production.s3.eu-west-1.amazonaws.com/images/ef30bea5e1454b30b4a858b524c621a8/s/ef30bea5e1454b30b4a858b524c621a8.png",
    "url_medium": "https://erudus-two-production.s3.eu-west-1.amazonaws.com/images/ef30bea5e1454b30b4a858b524c621a8/m/ef30bea5e1454b30b4a858b524c621a8.png",
    "url_large": null
  }
}