POST/fetchFree

Fetch Task

Get the current status and result of a task. Use this to poll for completion if you're not using webhooks.

Request Parameters

Parameter	Type	Required	Description
task_id	`string`	Required	UUID of the task to fetch.

Example Request

cURL

curl -X POST https://api.journeyapi.com/api/v1/fetch \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task_id": "550e8400-e29b-41d4-a716-446655440000"
  }'

Response

200 OK

// Processing
{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "task_type": "imagine",
  "model": "midjourney",
  "status": "processing",
  "percentage": "45"
}

// Finished — Midjourney (grid)
{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "task_type": "imagine",
  "model": "midjourney",
  "status": "finished",
  "percentage": "100",
  "original_image_url": "https://cdn.midjourney.com/abc123/grid_0.png",
  "image_urls": [
    "https://cdn.midjourney.com/abc123/0_0.png",
    "https://cdn.midjourney.com/abc123/0_1.png",
    "https://cdn.midjourney.com/abc123/0_2.png",
    "https://cdn.midjourney.com/abc123/0_3.png"
  ]
}

// Finished — Flux (single image)
{
  "task_id": "661f9511-f30c-52e5-b827-557766551111",
  "task_type": "imagine",
  "model": "flux-pro",
  "status": "finished",
  "percentage": "100",
  "image_url": "https://images.journeyapi.com/flux/abc123.png"
}

// Failed
{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "task_type": "imagine",
  "model": "midjourney",
  "status": "failed",
  "error": "Content policy violation"
}

Response Fields

Field	Type	Description
task_id	`string`	UUID of the task.
task_type	`string`	The endpoint that created this task.
model	`string`	The AI model used (e.g., "midjourney", "flux-pro").
status	`string`	"staged", "pending", "starting", "processing", "finished", or "failed".
percentage	`string`	Progress from "0" to "100".
original_image_url	`string`	Grid image URL (grid-type tasks only).
image_urls	`string[]`	Individual image URLs (grid-type tasks only).
image_url	`string`	Single image URL (upscale/faceswap tasks only).
video_urls	`string[]`	Video URLs (video tasks only).
content	`string[]`	Text content (describe/shorten tasks only).
seed	`string`	Seed value (seed tasks only).
error	`string`	Error message (failed tasks only).

Tips

1Poll every 5-10 seconds. Don't poll more frequently — it won't speed things up.
2Prefer webhooks over polling for production use. Polling is best for debugging.
3Free to call — no credits consumed.

Quirks & Gotchas

This is a POST endpoint (not GET) for consistency with the rest of the API.

The response shape varies depending on task_type and status. Check status first before accessing type-specific fields.

Related Endpoints

POST/fetch-many