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

# Working Within a Case

> Navigate the tabs and side panel of a dispute case in the Disputes portal, and manage documents, evidence, activity, and transaction views.

Once you open a dispute case in the Disputes portal, you can review, manage, and document the dispute.
This guide covers how to navigate the case tabs, use the side panel, manage documents and evidence, monitor provisional credit deadlines, track case activity, and work with transaction views.

<Frame>
  <img src="https://mintcdn.com/marqeta-b295cded/6HTPvxtY28nz8-YB/images/docs/developer-guides/disputes-portal/disputes-portal-case-view.png?fit=max&auto=format&n=6HTPvxtY28nz8-YB&q=85&s=85741fce4dc4562079141c2909f7d4bb" alt="Single disputes case view" width="2898" height="1576" data-path="images/docs/developer-guides/disputes-portal/disputes-portal-case-view.png" />
</Frame>

<h2 id="_case_tabs">
  Case tabs
</h2>

Each case has tabs across the top of the screen that organize its information and tools.
Click a tab to switch between views without leaving the case.

* **Dispute Lifecycle** — The main workspace for managing the case. See [Transitioning Cases](/developer-guides/disputes-portal-transitioning-and-closing/) for details on working in this tab.
* **Documents** — Upload and review files attached to the case.
* **Evidences** — Upload and manage evidence for the case.
* **Activity** — A history of every action taken on the case.
* **Related Transactions** — The complete transaction timeline, from authorization through chargeback.
* **User Transactions** — All transactions associated with the cardholder.

<h2 id="_side_panel">
  Side panel
</h2>

The side panel on the right stays visible while you work across all tabs.
It provides quick reference information without requiring you to navigate away from your current view.
Click any section in the side panel to expand it and see more details.

The side panel includes:

* **Point of Interaction** — Details about where and how the transaction occurred.
* **Merchant** — Information about the merchant involved in the transaction.
* **Cardholder profile** — Details about the cardholder who filed the dispute.
* **Card details** — Information about the card used in the transaction.
* **User disputes summary** — A summary of the cardholder's dispute history.
* **Transaction disputes overview** — An overview of disputes associated with the transaction.

<h2 id="_regulation_timeline">
  Regulation timeline
</h2>

The **Regulation Timeline** on the **Dispute Lifecycle** tab tracks provisional credit obligations for the case.
It shows:

* When provisional credit must be issued.
* How long provisional credit has been active.
* When provisional credit becomes permanent.

You can grant provisional credit directly from the **Regulation Timeline** without leaving the case.

<h2 id="_case_details">
  Case details
</h2>

The **Case Details** section on the **Dispute Lifecycle** tab provides a summary of the case at a glance.

<Frame>
  <img src="https://mintcdn.com/marqeta-b295cded/6HTPvxtY28nz8-YB/images/docs/developer-guides/disputes-portal/disputes-portal-case-details.png?fit=max&auto=format&n=6HTPvxtY28nz8-YB&q=85&s=115a718d1410864055100eca87691b0f" alt="Cased details screen" width="2180" height="1286" data-path="images/docs/developer-guides/disputes-portal/disputes-portal-case-details.png" />
</Frame>

Card details includes:

* **Current dispute state** — Where the case is in the lifecycle.
* **Transaction token** — The unique identifier for the disputed transaction. Click the copy icon to copy the token to your clipboard.
* **Network case number** — The card network's identifier for the case.
* **Assigned team member** — The person currently responsible for the case.
* **Dispute amount** — The amount being disputed.
* **Dispute reason code** — The card network reason code that classifies the dispute.

<h2 id="_documents_tab">
  Documents tab
</h2>

The **Documents** tab is where you can upload and review case-related documents from the cardholder, merchant and network.

<Frame>
  <img src="https://mintcdn.com/marqeta-b295cded/6HTPvxtY28nz8-YB/images/docs/developer-guides/disputes-portal/disputes-portal-documents-tab.png?fit=max&auto=format&n=6HTPvxtY28nz8-YB&q=85&s=4ffd84786d40641029980669cde78f50" alt="Documents tab screen" width="2888" height="1122" data-path="images/docs/developer-guides/disputes-portal/disputes-portal-documents-tab.png" />
</Frame>

To upload a file, click **Upload files** and choose the file from your device.
Supported file types are PDF, JPG, and TIFF, with a maximum size of 2 MB per file.
There is no limit on the number of documents you can attach to a case.

You can also generate a PDF directly from a text entry.
This is useful for creating a record when you don't have a separate file to attach.

<h2 id="_evidences_tab">
  Evidences tab
</h2>

The **Evidences** tab is where you upload and manage evidence that you have performed the necessary regulatory milestones related to the disputes case.

<Frame>
  <img src="https://mintcdn.com/marqeta-b295cded/6HTPvxtY28nz8-YB/images/docs/developer-guides/disputes-portal/disputes-portal-evidences-tab.png?fit=max&auto=format&n=6HTPvxtY28nz8-YB&q=85&s=2f14911880bf95531a9fba2d0a421aff" alt="Evidences tab screen" width="2872" height="328" data-path="images/docs/developer-guides/disputes-portal/disputes-portal-evidences-tab.png" />
</Frame>

<h2 id="_activity_tab">
  Activity tab
</h2>

The **Activity** tab shows every action taken on a case, with the most recent action at the top.

<Frame>
  <img src="https://mintcdn.com/marqeta-b295cded/6HTPvxtY28nz8-YB/images/docs/developer-guides/disputes-portal/disputes-portal-activity-tab.png?fit=max&auto=format&n=6HTPvxtY28nz8-YB&q=85&s=99409ff04db47414c1d6b2c6c59a7ab3" alt="Activity tab screen" width="2900" height="1388" data-path="images/docs/developer-guides/disputes-portal/disputes-portal-activity-tab.png" />
</Frame>

<h3 id="_filtering_activity">
  Filtering activity
</h3>

Use the activity filters to focus on specific types of actions:

* **Transitions** — Case state changes.
* **Events** — System or external events.
* **Milestones** — Key regulatory or lifecycle milestones.
* **Other** — Remaining activity types.

<h2 id="_working_with_transaction_views">
  Working with transaction views
</h2>

The **User Transactions** tab shows all transactions across all of a user's cards.
The controls help you manage what you see.

<Frame>
  <img src="https://mintcdn.com/marqeta-b295cded/6HTPvxtY28nz8-YB/images/docs/developer-guides/disputes-portal/disputes-portal-user-transactions-tab.png?fit=max&auto=format&n=6HTPvxtY28nz8-YB&q=85&s=3e991f17b56cb21aac70591ff0c5299d" alt="User transactions tab screen" width="2840" height="1570" data-path="images/docs/developer-guides/disputes-portal/disputes-portal-user-transactions-tab.png" />
</Frame>

<h3 id="_adjusting_how_many_transactions_you_see">
  Adjusting how many transactions you see
</h3>

By default, the **User Transactions** tab shows the last 50 transactions.
You can load more when an investigation calls for it by selecting the option to view additional transactions and choosing the number that fits your needs.

<Note>
  Loading more transactions takes longer.
  Use the **All Transactions** option only when you truly need the full history.
</Note>

<h3 id="_customizing_column_headers">
  Customizing column headers
</h3>

Select or clear boxes to show or hide columns, and click and drag headers up or down to reorder them.
Your preferences are saved automatically.

<h3 id="_using_quick_filters">
  Using quick filters
</h3>

Quick filters sit between the search bar and the filter icon.
You can use them to find the following common transaction types:

* **Disputable** — Show only transactions that can be disputed.
* **Refunds only** — Show only refund transactions.

<h2 id="_finding_specific_transactions">
  Finding specific transactions
</h2>

You can use the following ways to narrow down transactions within a case:

* filtering to a single card.
* using dynamic column filtering.

<h3 id="_searching_within_a_single_card">
  Searching within a single card
</h3>

The **User Transactions** tab spans all of a user's cards.

<Frame>
  <img src="https://mintcdn.com/marqeta-b295cded/6HTPvxtY28nz8-YB/images/docs/developer-guides/disputes-portal/disputes-portal-user-transactions-filter.png?fit=max&auto=format&n=6HTPvxtY28nz8-YB&q=85&s=671c7166b27a0aae50d9e6227c2b1e02" alt="User transactions filter screen" width="1874" height="1718" data-path="images/docs/developer-guides/disputes-portal/disputes-portal-user-transactions-filter.png" />
</Frame>

To narrow down to one card:

<Steps>
  <Step>Go to the **User Transactions** tab.</Step>
  <Step>Click **Filter**.</Step>
  <Step>Click **Cards** under **Transaction Filter**.</Step>
  <Step>Click the circle next to the card for which you want to see the associated transactions.</Step>
  <Step>Click **Apply**.</Step>
</Steps>

You'll now see only the transactions made with that card.

<h3 id="_using_dynamic_filtering">
  Using dynamic filtering
</h3>

You can filter transactions directly from the column headers.
Type your search criteria into any column header, and the results filter automatically as you type.
Add criteria to multiple columns to narrow the search further.

<Tip>To find a specific authorization and its related clearing transaction, type the approval code (auth code) into the column header. Both transactions share the code, so they appear together.</Tip>


## Related topics

- [Working with UX Toolkit within Native Webviews](/docs/developer-guides/uxt-within-native-webviews.md)
- [Working with Regulation E](/docs/developer-guides/disputes-regulation-e.md)
- [Working with UX Toolkit Web Components](/docs/developer-guides/uxt-web-components.md)
- [Disputes Overview](/docs/developer-guides/disputes-landing-page.md)
- [About the Disputes Portal](/docs/developer-guides/about-disputes-portal.md)
