---
title: "/claim/retrieve"
method: POST
path: "/claim/retrieve"
tags: ["Status"]
---

# /claim/retrieve

`POST /claim/retrieve`

Use this endpoint to retrieve claim details and status

## 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
  - `statusRole` string, required — Status role of the current user

## Response `200`

Successful status retrieve request

- object
  - `ClaimType` string
  - `ClaimReason` string
  - `ClaimReasonType` string
  - `TotalClaimAmount` number
  - `IsRegE10Satisfied` boolean — Whether the Reg E 10 Business Day provisional credit obligation has been satisfied.
  - `RegE10` string, Date-Time — The deadline by which provisional credit must be granted and the provisional credit letter sent — 10 business days from the contact date (for ATM/debit POS and non-US ATM disputes).
  - `RegE10Threshold` string, Date-Time — The approaching/warning date for the Reg E 10 milestone, used to trigger early action before the RegE10 deadline.
  - `IsRegESatisfied` boolean — Whether the final Reg E resolution deadline has been satisfied.
  - `RegEDeadline` string, Date-Time — The final Reg E regulatory deadline by which the claim must be resolved (write-off executed and resolution letter sent). 90 days for POS/non-US ATM disputes; 45 days for US ATM and ACH disputes.
  - `RegEThreshold` string, Date-Time — The approaching/warning date for the final Reg E deadline (RegEDeadline), used to trigger action before the deadline is breached.
  - `IsRegZ30Satisfied` boolean — Whether the Reg Z 30-day acknowledgement obligation has been satisfied.
  - `RegZ30` string, Date-Time — The deadline by which an acknowledgement letter must be sent to the cardholder — 30 days from the contact date.
  - `RegZ30Threshold` string, Date-Time — The approaching/warning date for the Reg Z 30 milestone.
  - `IsRegZPCSatisfied` boolean — Whether the Reg Z Withholding Protection provisional credit obligation has been satisfied.
  - `RegZPC` string, Date-Time — The Reg Z Withholding Protection date — the deadline by which provisional credit must be issued to prevent collection on the disputed amount (primarily relevant for cardholders enrolled in autopayment). Set to the earlier of the next autopayment date or statement cycle date, with a minimum of contact date + 3 business days.
  - `RegZPCThreshold` string, Date-Time — The approaching/warning date for the Reg Z PC provisional credit milestone.
  - `IsRegZ90Satisfied` boolean — Whether the Reg Z 90-day resolution obligation has been satisfied.
  - `RegZ90` string, Date-Time — The final Reg Z deadline by which write-off must be executed and a resolution letter sent. Equals the 2nd statement cycle date following the contact date, capped at 90 days. Defaults to 60 days if cycle date is unavailable or the calculated date falls below 60 days.
  - `RegZ90Threshold` string, Date-Time — The approaching/warning date for the Reg Z 90 milestone.
  - `CustomerDetails` object
    - `FirstName` string
    - `MiddleName` string
    - `LastName` string
    - `EmailAddress` string
    - `PhoneNumber` string
    - `LastAddressChangeDate` string, Date-Time
    - `CustomerId` string
  - `Address` object
    - `Line1` string — Mailing address line 1
    - `Line2` string — Mailing address line 2
    - `Line3` string — Mailing address line 3
    - `City` string — Mailing address City
    - `State` string — Mailing address 2 character State code
    - `Zip` string — Mailing address zip code (5 digits or 5-4 digites)
    - `Country` string — Mailing address Country code
  - `AccountDetails` object
    - `Description` string
    - `AccountNumber` string
    - `CardDescription` string
    - `CardNumber` string
    - `Balance` number
    - `OpenDate` string, Date-Time
    - `AccountStatus` string
    - `LastStatementDate` string, Date-Time
  - `ExternalCaseId` string — Optional ID representing claim identifier external to this dispute system (client internal identifier)
  - `CustomerContactDate` string, Date-Time — Date customer contacted institution about dispute
  - `CreateName` string — userId of the user who created the claim
  - `AccountType` string
  - `ClaimStatus` string
  - `AccountHolder` string
  - `Actions` object[] — Actions that can be taken on the claim
    - `Importance` string — Importance of the action
    - `ActionName` string — Action Name
  - `HasOutstandingTasks` boolean — Does the claim have oustanding workable tasks for interaction api
  - `HeaderDisplay` string — Text for display
  - `Stages` object[] — List of claim stages
    - `Status` string — Status of this stage
    - `Name` string — Name of this stage
  - `StatusList` object[]
    - `Type` 'Error' | 'Success' — Status of the request
    - `Message` string — Message about the status
    - `Code` string — Numeric code for the status
  - `TalkingPoints` object[] — List of claim talking points
    - `DisplayText` string — Text for display
  - `rtoken` string, nullable — A system-generated ID used for tracking
  - `StatusCode` integer, nullable — The HTTP response status code

## Other responses

- `400` — Error retrieve status request
- `500` — Error retrieve status 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/revisions/bcd728f97a18/schema)
