---
title: "Retrieve job status"
method: GET
path: "/v3/status/{jobId}"
tags: ["Custom Scripts"]
---

# Retrieve job status

`GET /v3/status/{jobId}`

## Request

- Base URL: `https://illustrator-api.adobe.io`
- URL: `https://illustrator-api.adobe.io/v3/status/{jobId}`
- Auth: HTTP bearer and API key in header `x-api-key`

Poll execution status for a Custom Scripts job. Use this after calling custom script execute. When the job succeeds, each entry in `outputs` includes a presigned URL to download an output file.

## Path parameters

- `jobId` string, required

## Response `200`

Success

- union
  - CustomScriptJobSucceededResponse: Returned when the Custom Scripts job completes successfully.
    - `jobId` string, required: The job ID.
    - `timestamp` string, date-time, required: ISO 8601 timestamp of when the status was recorded.
    - `status` 'succeeded', required
    - `data` object
      - `conversionDetails` CustomScriptJobConversionDetails: Details of the conversion performed during execution.
        - `inputFile` string: Name of the input Illustrator file.
        - `outputFolderPath` string: Name of the output folder.
        - `success` boolean: Whether conversion succeeded.
    - `outputs` CustomScriptOutputItem[], required: Presigned download URLs for each output file.
      - `destination` object, required: Presigned URL to download the output file.
        - `url` string, required: Presigned download URL.
      - `source` string, required: Relative path of the output file within the output folder.
  - CustomScriptJobRunningResponse: Returned while the Custom Scripts job is still executing. Poll again after a short interval.
    - `jobId` string, required: The job ID.
    - `timestamp` string, date-time, required: ISO 8601 timestamp.
    - `status` 'running', required
  - CustomScriptJobFailedResponse: Returned when the Custom Scripts job has failed.
    - `jobId` string, required: The job ID.
    - `timestamp` string, date-time, required: ISO 8601 timestamp.
    - `status` 'failed', required
    - `errors` object[], required: List of errors describing what went wrong.
      - `message` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Requested Resource Was Not Found
- `500`: Internal Server Error

## Changes

- **2026-10-29** `62ba1bac5f86`: 1 info
  - endpoint added
- **2026-05-05** `f4ae2cbc885a`: 1 breaking
  - api path removed without deprecation
- **2026-05-05** `e587e9302569`: 1 warning, 1 info
  - removed the optional property `oneOf[subschema #1: Execution Success]/data/conversionDetails/outputFolder` from the response with the `200` status
  - added the optional property `oneOf[subschema #1: Execution Success]/data/conversionDetails/outputFolderPath` to the response with the `200` status
- **2026-05-05** `896b87f47169`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adobe/apis/illustrator-api-firefly-services/changes/v3/status/:jobId/get.md)

---

[API](https://skmtc.dev/adobe/apis/illustrator-api-firefly-services.md) - [All operations](https://skmtc.dev/adobe/apis/illustrator-api-firefly-services/llms.txt) - [OpenAPI document](https://skmtc.dev/adobe/apis/illustrator-api-firefly-services/revisions/62ba1bac5f86?raw)