# List all disputes ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/disputes/list: get: summary: List all disputes deprecated: false description: Returns a list of your disputes. tags: - API Reference/Disputes parameters: - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Content-Type in: header description: '' required: true example: application/json schema: type: string requestBody: content: application/json: schema: type: object properties: charge: type: string description: >- Only return disputes associated to the charge specified by this charge ID. payment_intent: type: string description: >- Only return disputes associated to the PaymentIntent specified by this PaymentIntent ID. created: type: object properties: gt: type: integer description: >- Return results where the created field is greater than this value. gte: type: integer description: >- Return results where the created field is greater than or equal to this value. lt: type: string description: >- Return results where the created field is less than this value. lte: type: integer description: >- Return results where the created field is less than or equal to this value. description: >- A filter on the list based on the object created field. The value can be a string with an integer Unix timestamp, or it can be a dictionary with the following options: x-apifox-orders: - gt - gte - lt - lte ending_before: type: string description: >- A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list. limit: type: integer description: >- A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. starting_after: type: string description: >- A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list. x-apifox-orders: - charge - payment_intent - created - ending_before - limit - starting_after responses: '200': description: '' content: application/json: schema: type: object properties: object: type: string url: type: string has_more: type: boolean data: type: array items: type: object properties: id: type: string object: type: string amount: type: integer balance_transactions: type: array items: type: string charge: type: string created: type: integer currency: type: string evidence: type: object properties: access_activity_log: type: 'null' billing_address: type: 'null' cancellation_policy: type: 'null' cancellation_policy_disclosure: type: 'null' cancellation_rebuttal: type: 'null' customer_communication: type: 'null' customer_email_address: type: 'null' customer_name: type: 'null' customer_purchase_ip: type: 'null' customer_signature: type: 'null' duplicate_charge_documentation: type: 'null' duplicate_charge_explanation: type: 'null' duplicate_charge_id: type: 'null' product_description: type: 'null' receipt: type: 'null' refund_policy: type: 'null' refund_policy_disclosure: type: 'null' refund_refusal_explanation: type: 'null' service_date: type: 'null' service_documentation: type: 'null' shipping_address: type: 'null' shipping_carrier: type: 'null' shipping_date: type: 'null' shipping_documentation: type: 'null' shipping_tracking_number: type: 'null' uncategorized_file: type: 'null' uncategorized_text: type: 'null' required: - access_activity_log - billing_address - cancellation_policy - cancellation_policy_disclosure - cancellation_rebuttal - customer_communication - customer_email_address - customer_name - customer_purchase_ip - customer_signature - duplicate_charge_documentation - duplicate_charge_explanation - duplicate_charge_id - product_description - receipt - refund_policy - refund_policy_disclosure - refund_refusal_explanation - service_date - service_documentation - shipping_address - shipping_carrier - shipping_date - shipping_documentation - shipping_tracking_number - uncategorized_file - uncategorized_text x-apifox-orders: - access_activity_log - billing_address - cancellation_policy - cancellation_policy_disclosure - cancellation_rebuttal - customer_communication - customer_email_address - customer_name - customer_purchase_ip - customer_signature - duplicate_charge_documentation - duplicate_charge_explanation - duplicate_charge_id - product_description - receipt - refund_policy - refund_policy_disclosure - refund_refusal_explanation - service_date - service_documentation - shipping_address - shipping_carrier - shipping_date - shipping_documentation - shipping_tracking_number - uncategorized_file - uncategorized_text evidence_details: type: object properties: due_by: type: integer has_evidence: type: boolean past_due: type: boolean submission_count: type: integer required: - due_by - has_evidence - past_due - submission_count x-apifox-orders: - due_by - has_evidence - past_due - submission_count is_charge_refundable: type: boolean livemode: type: boolean metadata: type: object properties: {} x-apifox-orders: [] payment_intent: type: 'null' reason: type: string status: type: string x-apifox-orders: - id - object - amount - balance_transactions - charge - created - currency - evidence - evidence_details - is_charge_refundable - livemode - metadata - payment_intent - reason - status x-apifox-orders: - object - url - has_more - data example: object: list url: /v1/disputes has_more: false data: - id: dp_1M97r8L6kclEVx6M2LpvSCG3 object: dispute amount: 1000 balance_transactions: [] charge: ch_3K5l24L6kclEVx6M0ls3dCrx created: 1669643926 currency: eur evidence: access_activity_log: null billing_address: null cancellation_policy: null cancellation_policy_disclosure: null cancellation_rebuttal: null customer_communication: null customer_email_address: null customer_name: null customer_purchase_ip: null customer_signature: null duplicate_charge_documentation: null duplicate_charge_explanation: null duplicate_charge_id: null product_description: null receipt: null refund_policy: null refund_policy_disclosure: null refund_refusal_explanation: null service_date: null service_documentation: null shipping_address: null shipping_carrier: null shipping_date: null shipping_documentation: null shipping_tracking_number: null uncategorized_file: null uncategorized_text: null evidence_details: due_by: 1671321599 has_evidence: false past_due: false submission_count: 0 is_charge_refundable: true livemode: false metadata: {} payment_intent: null reason: general status: warning_needs_response headers: {} x-apifox-name: OK security: - basic: [] x-apifox-folder: API Reference/Disputes x-apifox-status: developing x-run-in-apifox: https://app.apifox.com/web/project/1296482/apis/api-44454250-run components: schemas: {} securitySchemes: basic: type: http scheme: basic servers: - url: https://apitest.wooshpay.com description: 官网测试 security: - basic: [] ```