---
title: "Poll a mockup generation"
method: GET
path: "/v1/images/mockup-status"
tags: ["Images"]
---

# Poll a mockup generation

`GET /v1/images/mockup-status`

## Request

- Base URL: `https://contentmaschine.ai/api`
- URL: `https://contentmaschine.ai/api/v1/images/mockup-status`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://contentmaschine.ai/api/oauth/authorize`, token URL `https://contentmaschine.ai/api/oauth/token`)

Returns the status of a mockup job started by POST /v1/images/mockup. Note this is a SEPARATE poller from GET /v1/jobs/{id} - a mockup job id is not a jobs-endpoint id.

## Query parameters

- `job_id` string, required

## Response `200`

Mockup job status.

- object
  - `success` boolean
  - `data` object
  - `timestamp` string, date-time

## Other responses

- `400`: job_id parameter is required.
- `401`: Missing or invalid API key.
- `404`: No such job, or it does not belong to you.
- `default`: Any other error. Every failure this API emits uses the same envelope; branch on `error.type`, never on `error.message`, and quote `error.correlation_id` to support.

---

[API](https://skmtc.dev/contentmaschine/apis/contentmaschine-ai-api.md) · [All operations](https://skmtc.dev/contentmaschine/apis/contentmaschine-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/contentmaschine/apis/contentmaschine-ai-api/revisions/28c74f46051c?raw)