v4

OpenAPI 3.1.02026-08-012402353.8 MB

List Card Disputes

get/card_disputes

Query parameters

cursorstring

Return the page of entries after this one.

limitinteger

Limit the size of the list that is returned. The default (and maximum) is 100 objects.

created_at.afterstring date-time

Return results after this ISO 8601 timestamp.

created_at.beforestring date-time

Return results before this ISO 8601 timestamp.

created_at.on_or_afterstring date-time

Return results on or after this ISO 8601 timestamp.

created_at.on_or_beforestring date-time

Return results on or before this ISO 8601 timestamp.

status.instring[]

Filter Card Disputes for those with the specified status or statuses. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three.

idempotency_keystring

Filter records to the one with the specified idempotency_key you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about idempotency.

Response

Card Dispute List

next_cursorstring nullable required

A pointer to a place in the list. Pass this as the cursor parameter to retrieve the next page of results. If there are no more results, the value will be null.

Example response

{
  "data": [
    {
      "amount": 1000,
      "card_id": "card_oubs0hwk5rn6knuecxg2",
      "created_at": "2020-01-31T23:59:59Z",
      "disputed_transaction_id": "transaction_uyrp7fld2ium70oa7oi",
      "id": "card_dispute_h9sc95nbl1cgltpp7men",
      "idempotency_key": null,
      "loss": null,
      "network": "visa",
      "rejection": null,
      "status": "pending_response",
      "type": "card_dispute",
      "user_submission_required_by": null,
      "visa": {
        "network_events": [],
        "required_user_submission_category": null,
        "user_submissions": [
          {
            "accepted_at": null,
            "amount": 1000,
            "attachment_files": [],
            "category": "chargeback",
            "chargeback": {
              "authorization": null,
              "category": "fraud",
              "consumer_canceled_merchandise": null,
              "consumer_canceled_recurring_transaction": null,
              "consumer_canceled_services": null,
              "consumer_counterfeit_merchandise": null,
              "consumer_credit_not_processed": null,
              "consumer_damaged_or_defective_merchandise": null,
              "consumer_merchandise_misrepresentation": null,
              "consumer_merchandise_not_as_described": null,
              "consumer_merchandise_not_received": null,
              "consumer_non_receipt_of_cash": null,
              "consumer_original_credit_transaction_not_accepted": null,
              "consumer_quality_merchandise": null,
              "consumer_quality_services": null,
              "consumer_services_misrepresentation": null,
              "consumer_services_not_as_described": null,
              "consumer_services_not_received": null,
              "fraud": {
                "fraud_type": "lost"
              },
              "processing_error": null
            },
            "created_at": "2020-01-31T23:59:59Z",
            "explanation": null,
            "further_information_requested_at": null,
            "further_information_requested_reason": null,
            "status": "pending_reviewing",
            "updated_at": "2020-01-31T23:59:59Z"
          }
        ]
      },
      "win": null,
      "withdrawal": null
    }
  ],
  "next_cursor": "v57w5d"
}