Collect member information

transactionUuid (string) — The transaction the request is about.
requestedItemKey (string) — The kind of item requested, for example PoliceReport. Absent when the request is free text.
customRequestedItems (array of string) — Free text items requested. Absent when requestedItemKey is set.
deadlineTimestamp (string) — Unix seconds. When the member's answer is due.

One of requestedItemKey or customRequestedItems is present, never both.

Example: an item from a list

{
  "type": "dispute.updated",
  "disputeUuid": "3f8e2c1a-9b47-4d6e-a1f0-7c2d5b8e4a91",
  "occurredAt": "2026-08-03T12:00:00Z",
  "data": {
    "dispute": {
      "uuid": "3f8e2c1a-9b47-4d6e-a1f0-7c2d5b8e4a91",
      "resolutionDeadline": "1788393600",
      "status": "DISPUTE_STATUS_OPEN",
      "transactions": [
        {
          "uuid": "txn-1",
          "settledTimestamp": "1783641600",
          "amount": {
            "amountInCents": 4500,
            "currency": "USD"
          },
          "merchant": "Acme Online Store",
          "status": "DISPUTED_TRANSACTION_STATUS_INVESTIGATING",
          "auditLog": [
            {
              "timestamp": "1785412800",
              "eventType": "TRANSACTION_EVENT_TYPE_REQUEST_MORE_INFO",
              "agentEmail": "sam.rivera@example.com"
            }
          ],
          "transactionStatus": "TRANSACTION_STATUS_SETTLED",
          "requiredActions": [
            "REQUIRED_ACTION_PROVIDE_MORE_INFO"
          ]
        }
      ],
      "shortId": "D-1042",
      "reason": "DISPUTE_REASON_MERCHANT_ISSUE",
      "disputeReason": {
        "reason": "DISPUTE_REASON_MERCHANT_ISSUE",
        "displayMessage": "Merchant Issue"
      }
    },
    "statusMessage": "Your dispute is under review.",
    "timeline": [
      {
        "eventType": "TIMELINE_EVENT_TYPE_INFORMATION_REQUESTED",
        "message": "We requested more information from you",
        "timestamp": "1785412800",
        "transactions": [
          {
            "uuid": "txn-1",
            "merchant": "Acme Online Store",
            "amount": {
              "amountInCents": 4500,
              "currency": "USD"
            },
            "settledTimestamp": "1783641600"
          }
        ]
      },
      {
        "eventType": "TIMELINE_EVENT_TYPE_CREATED",
        "message": "Dispute created",
        "timestamp": "1783728000"
      }
    ],
    "requiredActions": [
      {
        "type": "REQUIRED_ACTION_TYPE_COLLECT_CUSTOMER_INFORMATION",
        "collectCustomerInformation": {
          "transactionUuid": "txn-1",
          "requestedItemKey": "PoliceReport",
          "deadlineTimestamp": "1759708800"
        }
      }
    ]
  }
}

Example: a free text request

{
  "type": "dispute.updated",
  "disputeUuid": "3f8e2c1a-9b47-4d6e-a1f0-7c2d5b8e4a91",
  "occurredAt": "2026-08-03T12:00:00Z",
  "data": {
    "dispute": {
      "uuid": "3f8e2c1a-9b47-4d6e-a1f0-7c2d5b8e4a91",
      "resolutionDeadline": "1788393600",
      "status": "DISPUTE_STATUS_OPEN",
      "transactions": [
        {
          "uuid": "txn-1",
          "settledTimestamp": "1783641600",
          "amount": {
            "amountInCents": 4500,
            "currency": "USD"
          },
          "merchant": "Acme Online Store",
          "status": "DISPUTED_TRANSACTION_STATUS_INVESTIGATING",
          "auditLog": [
            {
              "timestamp": "1785412800",
              "eventType": "TRANSACTION_EVENT_TYPE_REQUEST_MORE_INFO",
              "agentEmail": "sam.rivera@example.com"
            }
          ],
          "transactionStatus": "TRANSACTION_STATUS_SETTLED",
          "requiredActions": [
            "REQUIRED_ACTION_PROVIDE_MORE_INFO"
          ]
        }
      ],
      "shortId": "D-1042",
      "reason": "DISPUTE_REASON_MERCHANT_ISSUE",
      "disputeReason": {
        "reason": "DISPUTE_REASON_MERCHANT_ISSUE",
        "displayMessage": "Merchant Issue"
      }
    },
    "statusMessage": "Your dispute is under review.",
    "timeline": [
      {
        "eventType": "TIMELINE_EVENT_TYPE_INFORMATION_REQUESTED",
        "message": "We requested more information from you",
        "timestamp": "1785412800",
        "transactions": [
          {
            "uuid": "txn-1",
            "merchant": "Acme Online Store",
            "amount": {
              "amountInCents": 4500,
              "currency": "USD"
            },
            "settledTimestamp": "1783641600"
          }
        ]
      },
      {
        "eventType": "TIMELINE_EVENT_TYPE_CREATED",
        "message": "Dispute created",
        "timestamp": "1783728000"
      }
    ],
    "requiredActions": [
      {
        "type": "REQUIRED_ACTION_TYPE_COLLECT_CUSTOMER_INFORMATION",
        "collectCustomerInformation": {
          "transactionUuid": "txn-1",
          "customRequestedItems": [
            "a receipt",
            "the cancellation email"
          ],
          "deadlineTimestamp": "1759708800"
        }
      }
    ]
  }
}

Reading requiredActions

Issue provisional credit