Retrieve a single job

GET

api

jobs

{job_id}

const response = await fetch("https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6", {
  method: "GET",
  headers: { "x-api-key": "sm_your_api_key" },
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init("https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: sm_your_api_key",
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

response = requests.get(
    "https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6",
    headers={"x-api-key": "sm_your_api_key"},
)

response.raise_for_status()
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6")
request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "sm_your_api_key"

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.body

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("x-api-key", "sm_your_api_key")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6"))
    .header("x-api-key", "sm_your_api_key")
    .GET()
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

using System.Net.Http;
using System.Text;

var request = new HttpRequestMessage(HttpMethod.Get, "https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6");
request.Headers.Add("x-api-key", "sm_your_api_key");

var client = new HttpClient();
var response = await client.SendAsync(request);

Console.WriteLine(await response.Content.ReadAsStringAsync());

curl -X GET "https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "x-api-key: sm_your_api_key"

{
  "created_at": "2026-09-18T10:24:31.482913+00:00",
  "credits_charged": 38,
  "job_id": "5f1c0b2a-7d43-4e9a-8c16-0b5d3f7a2e94",
  "kind": "video",
  "model": "veo-3.1-fast",
  "outcome_tier": "standard",
  "result_url": "https://cdn.sudomock.com/mockup-assets/videos/5f1c0b2a/clip.mp4",
  "status": "succeeded",
  "updated_at": "2026-09-18T10:41:07.118204+00:00",
  "error": null,
  "mockup_uuid": null,
  "payg": null,
  "watermark": null
}

const response = await fetch("https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6", {
  method: "GET",
  headers: { "x-api-key": "sm_your_api_key" },
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init("https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: sm_your_api_key",
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

response = requests.get(
    "https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6",
    headers={"x-api-key": "sm_your_api_key"},
)

response.raise_for_status()
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6")
request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "sm_your_api_key"

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.body

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("x-api-key", "sm_your_api_key")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6"))
    .header("x-api-key", "sm_your_api_key")
    .GET()
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

using System.Net.Http;
using System.Text;

var request = new HttpRequestMessage(HttpMethod.Get, "https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6");
request.Headers.Add("x-api-key", "sm_your_api_key");

var client = new HttpClient();
var response = await client.SendAsync(request);

Console.WriteLine(await response.Content.ReadAsStringAsync());

curl -X GET "https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "x-api-key: sm_your_api_key"

{
  "created_at": "2026-09-18T10:24:31.482913+00:00",
  "credits_charged": 38,
  "job_id": "5f1c0b2a-7d43-4e9a-8c16-0b5d3f7a2e94",
  "kind": "video",
  "model": "veo-3.1-fast",
  "outcome_tier": "standard",
  "result_url": "https://cdn.sudomock.com/mockup-assets/videos/5f1c0b2a/clip.mp4",
  "status": "succeeded",
  "updated_at": "2026-09-18T10:41:07.118204+00:00",
  "error": null,
  "mockup_uuid": null,
  "payg": null,
  "watermark": null
}

Authorizations

x-api-key

string

header

required

API key with sm_ prefix. Get your key at https://sudomock.com/dashboard/api-keys

Path Parameters

job_id

string

required

Id returned when this job was accepted.

Response

200 - application/json

Successful Response

Where a job stands right now, and its result once it has finished.

job_id

string

required

Identifier of this job.

Example:

"5f1c0b2a-7d43-4e9a-8c16-0b5d3f7a2e94"

kind

string

required

What this job does: render, video, upload, 2d_create, 2d_render, photo_mockup_create, photo_mockup_render or seam_fix.

Example:

"video"

status

enum<string>

required

Where the job stands, and it is over once this reads succeeded, failed or cancelled.

Available options:

queued,

dispatched,

running,

succeeded,

failed,

cancelled

created_at

string

required

When this job was submitted.

Example:

"2026-09-18T10:24:31.482913+00:00"

updated_at

string

required

When this job last changed.

Example:

"2026-09-18T10:41:07.118204+00:00"

result_url

string | null

Link to the finished file, or the path of the mockup that was created, and null until the job succeeds.

Example:

"https://cdn.sudomock.com/mockup-assets/videos/5f1c0b2a/clip.mp4"

mockup_uuid

string | null

Identifier of the mockup this job created, and null for jobs that hand back a file instead.

error

JobError · object | null

Why the job produced no result, and null unless it failed or was cancelled.

Show child attributes

credits_charged

integer | null

Credits you actually paid for this job, which is zero once a failed or cancelled job has been refunded.

Example:

38

payg

JobPaygCost · object | null

Pay as you go cost of this job, and null when it was paid for with plan or extra credits.

Show child attributes

watermark

JobWatermark · object | null

Why this result is marked and how to get unmarked results, and null when the result is clean.

Show child attributes

model

string | null

The video model that produced this clip, present on video jobs only.

outcome_tier

string | null

The quality level this clip was produced at, present on video jobs only.

Example:

"standard"

alternative_url

string | null

Link to a second fixed version of the tile, present on seam fix jobs only, and null unless the job succeeded with one.

result_status

enum<string> | null

How the fixed tile repeats, checked again at no cost: seamless, faint_seam or visible_seam. Present on seam fix jobs only, and null until the job succeeds.

Available options:

seamless,

faint_seam,

visible_seam

Example:

"seamless"

changes

enum<string> | null

What the fix changed: edges when only the area along the edges changed, whole_tile when the change reaches across the tile, rearranged when motifs were moved so none is cut. Present on seam fix jobs only, and null until the job succeeds.

Available options:

edges,

whole_tile,

rearranged

Example:

"edges"

fine_detail

enum<string> | null

How the tile's fine detail came out of the fix: unchanged, or softer when the tile was rebuilt. Present on seam fix jobs only, and null until the job succeeds and on fixes older than this field.

Available options:

unchanged,

softer

Example:

"unchanged"

changed_area

enum<string> | null

How much of the tile the fix changed: part, or whole when all of it changed. Present on seam fix jobs only, and null until the job succeeds and on fixes older than this field.

Available options:

part,

whole

Example:

"part"

stage

enum<string> | null

How far a seam fix has come: queued, fixing or finishing. It only moves forward. Present on seam fix jobs only.

Available options:

queued,

fixing,

finishing

Example:

"fixing"

const response = await fetch("https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6", {
  method: "GET",
  headers: { "x-api-key": "sm_your_api_key" },
});

const data = await response.json();
console.log(data);

<?php

$ch = curl_init("https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: sm_your_api_key",
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

response = requests.get(
    "https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6",
    headers={"x-api-key": "sm_your_api_key"},
)

response.raise_for_status()
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6")
request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "sm_your_api_key"

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.body

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("x-api-key", "sm_your_api_key")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6"))
    .header("x-api-key", "sm_your_api_key")
    .GET()
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

using System.Net.Http;
using System.Text;

var request = new HttpRequestMessage(HttpMethod.Get, "https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6");
request.Headers.Add("x-api-key", "sm_your_api_key");

var client = new HttpClient();
var response = await client.SendAsync(request);

Console.WriteLine(await response.Content.ReadAsStringAsync());

curl -X GET "https://api.sudomock.com/api/v1/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "x-api-key: sm_your_api_key"

{
  "created_at": "2026-09-18T10:24:31.482913+00:00",
  "credits_charged": 38,
  "job_id": "5f1c0b2a-7d43-4e9a-8c16-0b5d3f7a2e94",
  "kind": "video",
  "model": "veo-3.1-fast",
  "outcome_tier": "standard",
  "result_url": "https://cdn.sudomock.com/mockup-assets/videos/5f1c0b2a/clip.mp4",
  "status": "succeeded",
  "updated_at": "2026-09-18T10:41:07.118204+00:00",
  "error": null,
  "mockup_uuid": null,
  "payg": null,
  "watermark": null
}

API reference

PSD mockups

Photo mockups

Folders

Fonts

Video mockups

Background removal

Patterns

Studio

Webhook endpoints

Webhook deliveries

Jobs

Account

Retrieve a single job

Authorizations

Path Parameters

Response