> ## 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. # Disputes Evidence Collection > Learn how to use the Cases endpoint to submit evidence for disputes. export const EndpointCard = ({method = "API", title, children, href, arrow = true}) => { const METHOD_STYLES = { GET: { bg: "mint-bg-green-400/20 dark:mint-bg-green-400/20", text: "mint-text-green-700 dark:mint-text-green-400", border: "mint-border-green-300 dark:mint-border-green-700" }, POST: { bg: "mint-bg-blue-400/20 dark:mint-bg-blue-400/20", text: "mint-text-blue-700 dark:mint-text-blue-400" }, PUT: { bg: "mint-bg-yellow-400/20 dark:mint-bg-yellow-400/20", text: "mint-text-yellow-700 dark:mint-text-yellow-400" }, PATCH: { bg: "mint-bg-orange-400/20 dark:mint-bg-orange-400/20", text: "mint-text-orange-700 dark:mint-text-orange-400" }, DELETE: { bg: "mint-bg-red-400/20 dark:mint-bg-red-400/20", text: "mint-text-red-700 dark:mint-text-red-400" }, API: { bg: "mint-bg-black", text: "mint-text-white" } }; const MethodBadge = ({method}) => { const style = METHOD_STYLES[method?.toUpperCase()] ?? METHOD_STYLES.GET; return {method?.toUpperCase()} ; }; const content =

{}

{title}

{children &&

{children}

}

; if (!href) return content; return {content} ; }; Managed by Marqeta (MxM) customers and hybrid card programs must submit evidence for [Regulation E](/developer-guides/disputes-regulation-e/) disputes to the `/cases` endpoint. Evidence collection requirements vary by program type, as described in the following table. | Program type | Program responsibility | Required evidence | | -------------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | MxM JIT programs | Program provides money movement evidence; Marqeta handles communications | Documentation for provisional credit grant, reversal, and permanent credit submitted via API or the disputes portal within three business days | | Hybrid JIT programs | Program provides both money movement and communication evidence | Documentation for all credit events plus consumer communication records submitted via API or the disputes portal within three business days | | MxM pre-funded programs | Marqeta handles all evidence collection and communications | No evidence required — you can monitor dispute events through the disputes portal | | Hybrid pre-funded programs | Program provides communication evidence; Marqeta handles money movement evidence | Consumer communication dates and content for all credit events submitted via API or the disputes portal within three business days |

Create a dispute case event with evidence

**Action:** `POST`\ **Endpoint:** `/cases/{case_token}/events` Create a dispute case event with evidence.

Path parameter

| Fields | Description | | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | case\_token

string

Required | Unique identifier of the dispute case, generated by Marqeta.

**Allowable Values:**

36 char max |

Body field details

| Fields | Description | | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | name

string

Required | Name of the event.

**Allowable Values:**

255 char max | | category

string

Optional | Category to which the event belongs.

**Allowable Values:**

`REG_E` | | event\_date

string

Optional | Date and time of the event, in UTC.

**Allowable Values:**

Format: yyyy-MM-dd’T’HH:mm:ssZ | | created\_by

string

Required | User who created the event.

**Allowable Values:**

255 char max | | evidence\_details

object

Required | Details of the evidence for the dispute.

**Allowable Values:**

`pc_amount`, `webhook_id`, `notes`, `evidences` | | evidence\_details.**pc\_amount**

string

Required | Amount of provisional credit granted or reversed.

**Allowable Values:**

Any positive decimal greater than zero, written as a string | | evidence\_details.**webhook\_id**

string

Optional | Marqeta-generated identifier of the webhook associated with the case event.

**Allowable Values:**

255 char max | | evidence\_details.**notes**

string

Optional | Notes about the evidence.

**Allowable Values:**

255 char max | | evidence\_details.**evidences**

array of objects

Required | One or more objects containing evidence about the dispute.

**Allowable Values:**

Valid array of `evidences` objects | | evidence\_details.evidences\[].**evidence**

string

Required | Text containing evidence or evidence identifiers (such as a case document ID).

**Allowable Values:**

255 char max | | evidence\_details.evidences\[].**evidence\_type**

string

Required | Type of evidence submitted (ID, text content, or other).

**Allowable Values:**

`COMMUNICATION_CONTENT`, `EXTERNAL_TRANSACTION_ID`, `CRM_ID`, `CASE_DOCUMENT_ID`, `OTHER`

For `ProgramGrantedProvisionalCredit` or `ProgramRevertedProvisionalCredit` events, at least one submitted `evidence_type` must be `EXTERNAL_TRANSACTION_ID`.

For `ProgramCommunicatedGrantingProvisionalCredit` or `ProgramCommunicatedRevertingProvisionalCredit` events, at least one submitted `evidence_type` must be `COMMUNICATION_CONTENT`, `CRM_ID`, or `CASE_DOCUMENT_ID`. |

Response body

| Fields | Description | | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | token

string

Returned | Unique identifier of the event, generated by Marqeta.

**Allowable Values:**

36 char max | | case\_token

string

Returned | Unique identifier of the associated case that triggered this event, generated by Marqeta.

**Allowable Values:**

36 char max | | name

string

Returned | Name of the event.

**Allowable Values:**

255 char max | | category

string

Conditionally returned | Category to which the event belongs.

**Allowable Values:**

`REG_E` | | created\_by

string

Returned | User who created the event.

**Allowable Values:**

255 char max | | event\_date

string

Conditionally returned | Date and time of the event, in UTC.

**Allowable Values:**

Format: yyyy-MM-dd’T’HH:mm:ssZ | | created\_time

string

Returned | Date and time when the event was created, in UTC.

**Allowable Values:**

Format: yyyy-MM-dd’T’HH:mm:ssZ |

Sample request

```json JSON expandable lines wrap theme={null} { "name": "ProgramCommunicatedGrantingProvisionalCredit", "category": "REG_E", "created_by": "agent_123", "event_date": "2026-01-15T10:30:00Z", "evidence_details": { "pc_amount": "150.00", "webhook_id": "webhook_789", "notes": "Customer provided receipt", "evidences": [ { "evidence": "crm_case_12345", "evidence_type": "CRM_ID" }, { "evidence": "evidence 555", "evidence_type": "COMMUNICATION_CONTENT" } ] } } ```

Sample response

```json JSON lines wrap theme={null} { "token": "event_xyz789abc123", "case_token": "case_abc123def456", "name": "ProgramCommunicatedGrantingProvisionalCredit", "category": "REG_E", "event_date": "2026-01-15T10:30:00Z", "created_by": "agent_123", "created_time": "2026-01-15T10:30:15.123Z" } ```

Retrieve evidence for a case event

**Action:** `GET`\ **Endpoint:** `/cases/{case_token}/events/{event_token}/evidences` Retrieve evidence for a specific case event.

Path parameter

| Fields | Description | | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | case\_token

string

Required | Unique identifier of the dispute case, generated by Marqeta.

**Allowable Values:**

36 char max | | event\_token

string

Required | Unique identifier of the case event, generated by Marqeta.

**Allowable Values:**

36 char max |

Response body

Sample response

```json JSON lines wrap theme={null} { "pc_amount": "10.00", "notes": "Granted pc on date mentioned", "evidences": [ { "evidence": "12355sd343434", "evidence_type": "EXTERNAL_TRANSACTION_ID" }, { "evidence": "Communicated via email", "evidence_type": "COMMUNICATION_CONTENT" } ] } ```

Add evidence to an existing case event

**Action:** `POST`\ **Endpoint:** `/cases/{case_token}/events/{event_token}/evidences` Add evidence to an existing case event.

Path parameter

Body field details

| Fields | Description | | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | pc\_amount

string

Required | Amount of provisional credit granted or reversed.

**Allowable Values:**

Any positive decimal greater than zero, written as a string | | webhook\_id

string

Optional | Marqeta-generated identifier of the webhook associated with the case event.

**Allowable Values:**

255 char max | | notes

string

Optional | Notes about the evidence.

**Allowable Values:**

255 char max | | evidences

array of objects

Required | One or more objects containing evidence about the dispute.

**Allowable Values:**

Valid array of `evidences` objects | | evidences\[].**evidence**

string

Required | Text containing evidence or evidence identifiers (such as a case document ID).

**Allowable Values:**

255 char max | | evidences\[].**evidence\_type**

string

Required | Type of evidence submitted (ID, text content, or other).

**Allowable Values:**

`COMMUNICATION_CONTENT`, `EXTERNAL_TRANSACTION_ID`, `CRM_ID`, `CASE_DOCUMENT_ID`, `OTHER`

For `ProgramGrantedProvisionalCredit` or `ProgramRevertedProvisionalCredit` events, at least one submitted `evidence_type` must be `EXTERNAL_TRANSACTION_ID`.

For `ProgramCommunicatedGrantingProvisionalCredit` or `ProgramCommunicatedRevertingProvisionalCredit` events, at least one submitted `evidence_type` must be `COMMUNICATION_CONTENT`, `CRM_ID`, or `CASE_DOCUMENT_ID`. |

Response body

Sample request

```json JSON lines wrap theme={null} { "pc_amount": "109.45", "webhook_id": "webhookid-123", "notes": "Granted pc on date mentioned", "evidences": [ { "evidence": "evidence 111", "evidence_type": "OTHER" } ] } ```