POST/fetch-manyFree

Fetch Many Tasks

Get the status and results of multiple tasks in a single request. More efficient than calling /fetch repeatedly.

Request Parameters

Parameter	Type	Required	Description
task_ids	`string[]`	Required	Array of task UUIDs to fetch. Minimum 2, maximum 20.

Example Request

cURL

curl -X POST https://api.journeyapi.com/api/v1/fetch-many \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task_ids": [
      "550e8400-e29b-41d4-a716-446655440000",
      "661f9511-f30c-52e5-b827-557766551111",
      "772a0622-a41d-63f6-c938-668877662222"
    ]
  }'

Response

200 OK

{
  "tasks": [
    {
      "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": ["..."]
    },
    {
      "task_id": "661f9511-f30c-52e5-b827-557766551111",
      "task_type": "imagine",
      "model": "flux-pro",
      "status": "finished",
      "percentage": "100",
      "image_url": "https://images.journeyapi.com/flux/def456.png"
    },
    {
      "task_id": "772a0622-a41d-63f6-c938-668877662222",
      "task_type": "upscale-1x",
      "model": "midjourney",
      "status": "finished",
      "image_url": "https://cdn.midjourney.com/def456/0_1.png"
    }
  ]
}

Response Fields

Field	Type	Description
tasks	`object[]`	Array of task results, each in the same format as /fetch.

Tips

1Batch your /fetch calls into /fetch-many to reduce API round trips.
2Free to call — no credits consumed.

Quirks & Gotchas

Minimum 2 task IDs, maximum 20. Passing 1 or 21+ returns a 400 error.

If a task_id doesn't exist, it's silently omitted from the response.

Related Endpoints

POST/fetch