MobiariDocs
Admin APIProducts

List a product's media

GET
/stores/{store_id}/products/{product_id}/images

The active gallery: images (with their resized renditions in variants) and videos (media_type = video, cdn_url is the playable URL). Product-wide entries first, then variant-specific ones, each by position.

Authorization

bearer_auth
AuthorizationBearer <token>

Authorization: Bearer <token>. Either a session access token from POST /auth/login (refresh it with POST /auth/refresh) or a store API token (mobi_st_…). A store API token works only for the store it was issued in, and can do at most what its issuing user can there, narrowed to the scopes it was issued with.

In: header

Path Parameters

store_id*string

Store id

Formatuuid
product_id*string

Product id

Formatuuid

Query Parameters

limit?integer

Page size, 1 to 200. Defaults to 50.

Formatint64
Range1 <= value <= 200
cursor?string

next_cursor from the previous page. Omit for the first page.

offset?integer

Rows to skip, for UIs that jump to a page number. Ignored when cursor is set. Prefer cursor for walking a whole list.

Formatint64
Range0 <= value
include_total?boolean

Also return total, the count of all matching rows. Costs an extra query; leave off when you only walk pages.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/stores/497f6eca-6276-4993-bfeb-53cbbbba6f08/products/497f6eca-6276-4993-bfeb-53cbbbba6f08/images?limit=50"
{
  "data": [
    {
      "alt_text": "string",
      "cdn_url": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "extra_variant_ids": [
        "b2141a49-c616-47cb-817a-ab59b7d403de"
      ],
      "file_path": "string",
      "file_size_bytes": 0,
      "filename": "string",
      "height": 0,
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "image_kind": "string",
      "image_size": "string",
      "is_active": true,
      "is_primary": true,
      "media_type": "string",
      "mime_type": "string",
      "original_filename": "string",
      "position": 0,
      "poster_url": "string",
      "product_id": "0d012afa-f885-4e65-aeca-37e27701e2d1",
      "product_variant_id": "3346b03a-4660-4dfb-b5d0-e13608e6ced8",
      "provider": "string",
      "updated_at": "2019-08-24T14:15:22Z",
      "width": 0,
      "variants": [
        {
          "cdn_url": "string",
          "created_at": "2019-08-24T14:15:22Z",
          "file_path": "string",
          "file_size_bytes": 0,
          "height": 0,
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "mime_type": "string",
          "product_image_id": "54609007-3ca2-40c6-ae53-a6ebd6da0a5e",
          "quality": 0,
          "variant_name": "string",
          "width": 0
        }
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "string",
  "total": 0
}
{
  "code": "not_found",
  "details": {},
  "error": "Order not found"
}
{
  "code": "not_found",
  "details": {},
  "error": "Order not found"
}
{
  "code": "not_found",
  "details": {},
  "error": "Order not found"
}
{
  "code": "not_found",
  "details": {},
  "error": "Order not found"
}
{
  "code": "not_found",
  "details": {},
  "error": "Order not found"
}