Disputes Evidence Collection

Managed by Marqeta (MxM) customers and hybrid card programs must submit evidence for 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

{
  "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

{
  "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

Fields	Description
pc_amount string Returned	Amount of provisional credit granted or reversed. Allowable Values: Any positive decimal greater than zero, written as a string
webhook_id string Conditionally returned	Marqeta-generated identifier of the webhook associated with the case event. Allowable Values: 255 char max
notes string Conditionally returned	Notes about the evidence. Allowable Values: 255 char max
evidences array of objects Returned	One or more objects containing evidence about the dispute. Allowable Values: Valid array of `evidences` objects
evidences[].evidence string Returned	Text containing evidence or evidence identifiers (such as a case document ID). Allowable Values: 255 char max
evidences[].evidence_type string Returned	Type of evidence submitted (ID, text content, or other). Allowable Values: `COMMUNICATION_CONTENT`, `EXTERNAL_TRANSACTION_ID`, `CRM_ID`, `CASE_DOCUMENT_ID`, `OTHER`

Sample response

JSON

{
  "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

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

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

Fields	Description
pc_amount string Returned	Amount of provisional credit granted or reversed. Allowable Values: Any positive decimal greater than zero, written as a string
webhook_id string Conditionally returned	Marqeta-generated identifier of the webhook associated with the case event. Allowable Values: 255 char max
notes string Conditionally returned	Notes about the evidence. Allowable Values: 255 char max
evidences array of objects Returned	One or more objects containing evidence about the dispute. Allowable Values: Valid array of `evidences` objects
evidences[].evidence string Returned	Text containing evidence or evidence identifiers (such as a case document ID). Allowable Values: 255 char max
evidences[].evidence_type string Returned	Type of evidence submitted (ID, text content, or other). Allowable Values: `COMMUNICATION_CONTENT`, `EXTERNAL_TRANSACTION_ID`, `CRM_ID`, `CASE_DOCUMENT_ID`, `OTHER`

Sample request

JSON

{
  "pc_amount": "109.45",
  "webhook_id": "webhookid-123",
  "notes": "Granted pc on date mentioned",
  "evidences": [
    {
      "evidence": "evidence 111",
      "evidence_type": "OTHER"
    }
  ]
}

Sample response

JSON

{
  "pc_amount": "109.45",
  "webhook_id": "webhookid-123",
  "notes": "Granted pc on date mentioned",
  "evidences": [
    {
      "evidence": "evidence 111",
      "evidence_type": "OTHER"
    }
  ]
}

​Create a dispute case event with evidence

​Path parameter

​Body field details

​Response body

​Sample request

​Sample response

​Retrieve evidence for a case event

​Path parameter

​Response body

​Sample response

​Add evidence to an existing case event

​Path parameter

​Body field details

​Response body

​Sample request

​Sample response

Create a dispute case event with evidence

Path parameter

Body field details

Response body

Sample request

Sample response

Retrieve evidence for a case event

Path parameter

Response body

Sample response

Add evidence to an existing case event

Path parameter

Body field details

Response body

Sample request

Sample response