---
title: "Retrieve tasks with their schema"
method: POST
path: "/journey/task/list/schema"
---

# Retrieve tasks with their schema

`POST /journey/task/list/schema`

Fetch all currently active tasks along with their corresponding JSON schema. This allows you to see the expected input fields for each task in a single API call.

## Request body

- object
  - `instanceId` string, required — Unique identifier for the journey instance.

## Response `201`

Successfully retrieved tasks and schemas.

- object
  - `status` 'Completed' | 'InProgress' | 'Failed' | 'Paused', required — Current status of the journey instance.
  - `instanceId` string, required — Unique identifier for the active journey instance.
  - `tasks` object[], required — List of active tasks for the journey instance.
    - `taskId` string, required — Unique identifier for the task.
    - `variantId` string, required — Identifier for the task variant.
    - `schema` object, required — Contains a reference key that points to the corresponding schema definition in the schemas map.
  - `schemas` object, required — A map of schema identifiers to their JSON Schema (draft-07) definitions. Each key corresponds to the reference value in a task's schema object.

---

[API](https://skmtc.net/gbgplc/apis/gbg-go-api-reference.md) · [All operations](https://skmtc.net/gbgplc/apis/gbg-go-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gbgplc/gbg-go-api-reference/versions/71fc8231d3fb/schema)