> ## Documentation Index
> Fetch the complete documentation index at: https://docs.go.gbgplc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve tasks with their 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.



## OpenAPI

````yaml docs/go-v1/openapi-v1.json POST /journey/task/list/schema
openapi: 3.0.3
info:
  title: GBG GO API Reference
  description: >-
    The GBG GO API enables authentication, customer journey execution, task
    management, and tracking verification progress.
  version: 1.0.0
  license:
    name: MIT
servers:
  - url: https://eu.platform.go.gbgplc.com/captain/api
  - url: https://us.platform.go.gbgplc.com/captain/api
  - url: https://au.platform.go.gbgplc.com/captain/api
  - url: https://api.auth.gbgplc.com/as/token.oauth2
security:
  - bearerAuth: []
paths:
  /journey/task/list/schema:
    post:
      summary: Retrieve tasks with their schema
      description: >-
        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.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                instanceId:
                  type: string
                  description: Unique identifier for the journey instance.
                  example: PiIuACmx8Q8R7qPnAkLAqBAT
              required:
                - instanceId
      responses:
        '201':
          description: Successfully retrieved tasks and schemas.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - Completed
                      - InProgress
                      - Failed
                      - Paused
                    default: InProgress
                    description: Current status of the journey instance.
                  instanceId:
                    type: string
                    description: Unique identifier for the active journey instance.
                  tasks:
                    type: array
                    description: List of active tasks for the journey instance.
                    items:
                      type: object
                      properties:
                        taskId:
                          type: string
                          description: Unique identifier for the task.
                          example: Tkr7OENkIqYR8Y2CnrIW3TX-
                        variantId:
                          type: string
                          description: Identifier for the task variant.
                          example: US_AgeVerification_Source1IncludingDOB
                        schema:
                          type: object
                          description: >-
                            Contains a reference key that points to the
                            corresponding schema definition in the schemas map.
                      required:
                        - taskId
                        - variantId
                        - schema
                  schemas:
                    type: object
                    description: >-
                      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.
                    additionalProperties:
                      type: object
                      description: >-
                        JSON Schema defining the expected input structure for a
                        task.
                      properties:
                        type:
                          type: string
                          example: object
                        properties:
                          type: object
                          description: Top-level properties expected by the schema.
                          properties:
                            context:
                              type: object
                              description: >-
                                The context object containing subject and
                                metadata.
                              properties:
                                subject:
                                  type: object
                                  description: >-
                                    Subject data including identity and device
                                    information.
                                  properties:
                                    identity:
                                      type: object
                                      description: >-
                                        Identity fields such as firstName,
                                        lastNames, dateOfBirth, currentAddress,
                                        idNumbers, phones, and emails.
                                      properties:
                                        firstName:
                                          type: string
                                        lastNames:
                                          type: array
                                          items:
                                            type: string
                                        dateOfBirth:
                                          type: string
                                        currentAddress:
                                          type: object
                                          properties:
                                            lines:
                                              type: array
                                              items:
                                                type: string
                                            locality:
                                              type: string
                                            administrativeArea:
                                              type: string
                                            dependentLocality:
                                              type: string
                                            postalCode:
                                              type: string
                                            country:
                                              type: string
                                        idNumbers:
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              type:
                                                type: string
                                              idNumber:
                                                type: string
                                            required:
                                              - type
                                              - idNumber
                                        phones:
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              type:
                                                type: string
                                              number:
                                                type: string
                                            required:
                                              - number
                                        emails:
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              type:
                                                type: string
                                              email:
                                                type: string
                                            required:
                                              - email
                                        idType:
                                          type: string
                                        idIssuer:
                                          type: string
                                        idNumber:
                                          type: string
                                      required:
                                        - firstName
                                        - lastNames
                                    device:
                                      type: object
                                      description: Device information.
                                      properties:
                                        client:
                                          type: object
                                          properties:
                                            ip:
                                              type: string
                                    uid:
                                      type: string
                                  required:
                                    - identity
                                metadata:
                                  type: object
                                  description: Optional metadata fields.
                                  properties:
                                    invoice:
                                      type: string
                                    amount:
                                      type: string
                                    shipping:
                                      type: string
                                    tax:
                                      type: string
                                    total:
                                      type: string
                                    paymentMethod:
                                      type: string
                                    sku:
                                      type: string
                                    purchaseDate:
                                      type: string
                                    captureQueryId:
                                      type: string
                                    score:
                                      type: string
                                    custom1:
                                      type: string
                                    custom2:
                                      type: string
                                    custom3:
                                      type: string
                              required:
                                - subject
                          required:
                            - context
                        required:
                          type: array
                          items:
                            type: string
                          description: List of required top-level fields.
                required:
                  - instanceId
                  - status
                  - tasks
                  - schemas
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````