---
title: "/claim/intake/retrieveReasons"
method: POST
path: "/claim/intake/retrieveReasons"
tags: ["Intake"]
---

# /claim/intake/retrieveReasons

`POST /claim/intake/retrieveReasons`

Use this endpoint to retrieve the reason questionnaire for a given claim ID.

These are questions to display so the user can classify the type and reason for the claim. Because the dispute system now knows the customer account type and user type, it will return the appropriate questions.  

This first question drives the core type of dispute, which is one of the following five:

1. I participated in this transaction, but there is a problem.

2. I did not participate in this transaction, and I did not authorize anyone else to participate in this transaction.

3. I had an issue while using my card at an ATM.

4. There is an issue with a convenience check.

5. There is an issue with a balance transfer.

6. The merchant failed to obtain valid authorization.

The next set of questions is based on the above answer, and is specific for each.  This is a description of the reason for the type of claim.

Prerequisite API calls:
- `/claim/intake/create`

> 📘 Note
>
> This endpoint may return different data depending on the value of `profile-type`. See <a href="ref:api-reference-profile-type-differences" target="_blank">Profile Type Differences</a> for details.

## Request body

- object
  - `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"`
  - `ClaimId` string, required — Unique claim ID

## Response `200`

Successful retrieve reasons request

- object
  - `Questionnaire` object — Questionnaire for the user to provide answers for. PostQuestionnaire is to be presented to the user after they provide answers for Questionnaire
    - `QuestionList` object[] — A List of questions the user can answer. This QuestionList can be nested inside of another Question's AnswerList indicating that these questions should only be displayed if that Answer is selected.
      - `Identifier` string — Question identifier
      - `DisplayText` string — Text to display with the question
      - `DataType` 'String' | 'Decimal' | 'Integer' | 'Date' | 'DateTime' | 'Boolean' | 'List' — This list of question datatypes indicates what the `AnswerValue` can be: * `String` — Text, e.g., `Yes` * `Decimal` — Floating-point decimal, e.g., `14.52` * `Integer` — Integer, e.g., `15` * `Date` — Date with format yyyymmdd, e.g., `20240216` * `DateTime` — Datetime with format yyyyMMdd`T`HHmmss.SSS z, e.g., `20230201T225915.773 GMT` * `Boolean` — Boolean, either `true` or `false` * `List` — Text, where `Identifier` can be provided multiple times. See <a href="doc:creating-an-api-30-dispute#adding-list-answers" target="_blank">Adding `List` answers</a> for examples.
      - `Type` 'YesNo' | 'Date' | 'DateTime' | 'Text' | 'TextMulti' | 'Dropdown' | 'AutoComplete' | 'RadioButtons' | 'Checkboxes' | 'MultiSelect' | 'Decimal' | 'Integer' | 'Currency' | 'RichText' | 'Nothing' | 'Section' | 'Questionnaire' — Question type
      - `Format` 'Caption' | 'Default' | 'Internal' | 'Notification' | 'Warning' — Metadata describing the question format, can be used to optionally provide different visual treatment
      - `IsOptional` boolean — Is this question optional?
      - `AnswerList` object[] — A list of possible answers for a question
        - `Identifier` string — Unique answer identifier
        - `DisplayText` string — Answer text to display
      - `SelectedAnswer` string — The selected answer to this question. This could be a default for an initially loaded questionnaire or a persisted previous answer.
      - `APIDocumentationList` object[] — This is returned for questions of type Section. It provides the implementation details to provide the answer to said question.
        - `ImplementationNotes` string — Description of the connector
        - `Endpoint` string — REST connector endpoint suffix
        - `Method` string — Method for REST connector (always `POST`)
  - `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 retrieve reasons request
- `500` — Error retrieve reasons request

---

[API](https://skmtc.net/galileo-ft/apis/program-api.md) · [All operations](https://skmtc.net/galileo-ft/apis/program-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo-ft/program-api/versions/bcd728f97a18/schema)