---
title: "/task/list"
method: POST
path: "/task/list"
tags: ["Tasks"]
---

# /task/list

`POST /task/list`

## Request

- Base URL: `{corename}.gft-dispute-api.{env}.gpsrv.com/gft-dispute-api/1.0`
- URL: `{corename}.gft-dispute-api.{env}.gpsrv.com/gft-dispute-api/1.0/task/list`
- Auth: none declared

Use this endpoint to retrieve tasks for a client or claim

## Request body

- union
  - object
    - `ClaimId` string, required: Unique claim ID
    - `providerId` integer, required: Your unique provider identifier from SoFi Tech Solutions. Pattern: Max 10 digits Example: `9999`
    - `transactionId` string, required: Supply a globally unique ID to identify this endpoint request ("transaction"). Pattern: Max 60 characters Example: `"984513-395483653-4483483478"`
    - `PageNum` integer: page to retrieve, 1 if not included in request
    - `PageSize` integer: number of results per page, 1000 if not included in request
    - `SortBy` string: Field to sort by (ClaimAmount|NextRecoveryDateTime|etc) CreateDateTime if not included in request
    - `SortType` string: Ascending or Descending sort (ASC|DESC) ASC if not included in request
  - object
    - `ClientId` string, required: ClientId representing client for which tasks are being retrieved
    - `TaskLabel` string, required: Label of tasks being retrieved for said client
    - `providerId` integer, required: Your unique provider identifier from SoFi Tech Solutions. Pattern: Max 10 digits Example: `9999`
    - `transactionId` string, required: Supply a globally unique ID to identify this endpoint request ("transaction"). Pattern: Max 60 characters Example: `"984513-395483653-4483483478"`
    - `PageNum` integer: page to retrieve, 1 if not included in request
    - `PageSize` integer: number of results per page, 1000 if not included in request
    - `SortBy` string: Field to sort by (ClaimAmount|NextRecoveryDateTime|etc) CreateDateTime if not included in request
    - `SortType` string: Ascending or Descending sort (ASC|DESC) ASC if not included in request

## Response `200`

Successful task list request

- object
  - `TaskList` object[]
    - `ClaimAmount` number: Total claim amount
    - `ClaimAge` integer: Age of claims in days
    - `NextRecoveryDateTime` string: Next Recovery date time
    - `NextRegulatoryDateTime` string: Next Regulatory date time
    - `TaskLabel` string: label of task
    - `ClaimCategory` string: Claim category
    - `ClaimType` string: Claim type
    - `TaskId` string: UUID of task
  - `StatusList` object[]
    - `Type` 'Error' | 'Success': Status of the request
    - `Message` string: Message about the status
    - `Code` string: Numeric code for the status
  - `rtoken` string, nullable: A system-generated ID used for tracking
  - `StatusCode` integer, nullable: The HTTP response status code

## Other responses

- `400`: Error task list request
- `500`: Error task list request

---

[API](https://skmtc.dev/galileo-ft/apis/dispute-api-3-0.md) - [All operations](https://skmtc.dev/galileo-ft/apis/dispute-api-3-0/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo-ft/apis/dispute-api-3-0/revisions/cf13cabe7c95?raw)