Convert

Get convert job status

Returns the current status and per-item progress of a conversion job. Poll this endpoint until status is done, partial, or failed. Once done, call GET /api/convert/job/{uid}/results with the same X-Api-Key to retrieve per-item asset IDs. Authentication: X-Api-Key header required.

get/api/convert/job/{uid}

Request

  • Base URL: https://snapwonders.com
  • URL: https://snapwonders.com/api/convert/job/{uid}
  • Auth: API key in header X-Api-Key

Path parameters

uidstring uuid required

Either the upload_uid returned by POST /api/convert/session or the job_uid returned by POST /api/convert/job. Both identify the job.

Response

Job status

upload_uidstring uuid
job_uidstring uuid

Pass to GET /api/convert/job/{uid}/results with the same X-Api-Key to retrieve result files once complete.

status'queued' | 'processing' | 'completed' | 'partial' | 'failed' | 'terminated'
total_itemsinteger

Total number of files in this job

completedinteger

Number of items successfully converted

failedinteger

Number of items that failed

queued_atstring date-time nullable
started_atstring date-time nullable
completed_atstring date-time nullable

Example response

{
  "items": [
    {
      "name": "photo.jpg"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.