---
title: "Query Media processing status"
method: GET
path: "/media"
tags: ["Medias"]
---

# Query Media processing status

`GET /media`

## Request

- Base URL: `https://open.shopline.io/v1`
- URL: `https://open.shopline.io/v1/media`
- Auth: HTTP bearer

Requires the media index permission. Returns one result per requested Media ID in request order. Missing, removed, and foreign-owned IDs all return the same non-disclosing MEDIA_NOT_FOUND result. PENDING and PROCESSING are non-terminal; READY, FAILED, and MEDIA_NOT_FOUND are terminal. Images and alt_translations are returned only for READY Media.<br> 需要圖像查詢權限。系統會依照請求中的 Media ID 順序回傳結果。不存在、已移除或屬於其他商店的 ID 均回傳不洩露資訊的 MEDIA_NOT_FOUND。PENDING 與 PROCESSING 為非終止狀態；READY、FAILED 與 MEDIA_NOT_FOUND 為終止狀態。僅 READY 狀態的圖像會回傳 images 與 alt_translations。

## Query parameters

- `ids[]` string[], required

## Response `200`

Media processing states<br>圖像處理狀態

- object
  - `data` object
    - `items` MediaProcessing[]
      - `id` string: Media ID<br>圖像 ID
      - `client_reference_id` string, nullable: Client-provided correlation ID<br>客戶端提供的關聯 ID
      - `processing_status` 'PENDING' | 'PROCESSING' | 'READY' | 'FAILED' | 'MEDIA_NOT_FOUND': Current processing status<br>目前的處理狀態
      - `processing_error` object, nullable: Processing error; null when no error exists<br>處理錯誤；無錯誤時為 null
        - `code` 'UNSUPPORTED_COLORSPACE' | 'IMAGE_VALIDATION_FAILED' | 'STAGED_OBJECT_NOT_FOUND' | 'SOURCE_FETCH_FAILED' | 'SOURCE_FETCH_TIMEOUT' | 'PROCESSING_FAILED' | 'MEDIA_NOT_FOUND', required: Machine-readable error code<br>機器可讀的錯誤代碼
        - `message` string, required: Human-readable error message<br>人類可讀的錯誤訊息
      - `images` object: Present only when processing_status is READY<br>僅在 processing_status 為 READY 時回傳
        - `original` object: Original processed image metadata and CDN location<br>處理後原始圖像的中繼資料及 CDN 位置
          - `width` number: Processed image width in pixels<br>處理後圖像的寬度（像素）
          - `height` number: Processed image height in pixels<br>處理後圖像的高度（像素）
          - `url` string, uri: CDN URL of the ready processed image<br>處理完成圖像的 CDN 網址
      - `alt_translations` object: Present only when processing_status is READY<br>僅在 processing_status 為 READY 時回傳
  - `error` PublicApiError
    - `code` string, required: Machine-readable error code<br>機器可讀的錯誤代碼
    - `message` string, required: Human-readable error message<br>人類可讀的錯誤訊息
  - `trace_id` string

## Other responses

- `422`: Invalid Media IDs<br>無效的 Media ID

## Changes

- **2026-11-03** `d2518391b149`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shoplineapp/apis/shopline-open-api/changes/media/get.md)

---

[API](https://skmtc.dev/shoplineapp/apis/shopline-open-api.md) - [All operations](https://skmtc.dev/shoplineapp/apis/shopline-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shoplineapp/apis/shopline-open-api/revisions/d2518391b149?raw)