> ## Documentation Index > Fetch the complete documentation index at: https://flutterwaveinc.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List chargebacks ## OpenAPI ````yaml Flutterwave_v4_Open_API.json get /chargebacks openapi: 3.1.0 info: version: '1.0' title: Flutterwave APIs description: APIs for Enterprise Customers contact: name: Flutterwave email: hi@flutterwavego.com servers: - url: https://developersandbox-api.flutterwave.com description: Dev server security: - bearerAuth: [] paths: /chargebacks: get: tags: - Chargebacks summary: List chargebacks operationId: chargebacks_list parameters: - $ref: '#/components/parameters/trace_id' - $ref: '#/components/parameters/page' - $ref: '#/components/parameters/size' - $ref: '#/components/parameters/from_datetime' - $ref: '#/components/parameters/to_datetime' responses: '200': description: OK content: application/json: schema: type: object additionalProperties: false properties: status: $ref: '#/components/schemas/status' message: type: string meta: $ref: '#/components/schemas/list_response_meta' data: type: array maxItems: 10 items: $ref: '#/components/schemas/chargeback' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/400' '401': description: Unauthorised request content: application/json: schema: $ref: '#/components/schemas/401' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/403' components: parameters: trace_id: description: >- A unique identifier to track this operation. It must be between 12 and 255 characters in length. in: header name: X-Trace-Id schema: type: string minLength: 12 maxLength: 255 example: acb123e4-f567-4a8b-9c0d-1e2f3a4b5c6d page: in: query name: page description: >- The page of the data to retrieve. The most recent data entry is on page 1. schema: type: integer minimum: 1 default: 1 example: 1 size: in: query name: size description: Length of data returned. Defaults to 10. schema: type: integer minimum: 10 maximum: 50 default: 10 example: 10 from_datetime: in: query name: from schema: type: string format: date-time description: >- The start date and time for a period. This parameter is used in conjunction with the 'to' parameter to define a time range. The value should be in ISO 8601 format. example: '2025-04-21T10:55:16Z' to_datetime: in: query name: to schema: type: string format: date-time description: >- The end date and time for a period. This parameter is used in conjunction with the 'from' parameter to define a time range. The value should be in **ISO 8601 format**. example: '2025-05-21T10:48:18Z' schemas: '400': description: Bad Request type: object properties: status: type: string nullable: false enum: - failed error: type: object properties: type: type: string example: REQUEST_NOT_VALID code: type: string example: '10400' message: type: string nullable: true example: Request is not valid validation_errors: type: array items: type: object properties: field_name: type: string example: amount message: type: string example: must not be null description: >- The request cannot be accepted and is malformed and/or missing required parameters. '401': description: Unauthorized type: object properties: status: type: string nullable: false enum: - failed message: type: string nullable: true description: Invalid API key provided example: UNAUTHORIZED error: type: object properties: type: type: string example: UNAUTHORIZED code: type: string example: '10401' message: type: string example: unauthorized '403': description: Forbidden type: object properties: status: type: string nullable: false enum: - failed message: type: string description: API key doesn't have permission to access this resource error: type: object properties: type: type: string example: FORBIDDEN code: type: string example: '10403' message: type: string example: Forbidden status: type: string nullable: false enum: - success - failed list_response_meta: type: object properties: page_info: $ref: '#/components/schemas/page_info' chargeback: type: object description: A chargeback object properties: id: type: string description: ID of the chargeback example: 1 charge_id: type: string description: ID of the charge tied to this chargeback example: chg_eahdhfThdHsgaSra amount: allOf: - $ref: '#/components/schemas/amount' description: Amount to be charged back meta: $ref: '#/components/schemas/meta' stage: type: string description: The stage describes the current phase of a chargeback dispute enum: - new - second - pre-arbitration - arbitration - invalid example: new status: type: string description: >- The status field tracks the current state or outcome of a chargeback dispute, providing a comprehensive overview of its lifecycle. enum: - pending - accepted - declined - initiated - won - lost - reversed - new example: new type: type: string description: >- The type categorizes the chargeback based on whether it originates from a transaction within the same country (local) or across different countries (international). enum: - local - international example: local due_datetime: type: string description: >- The due_datetime specifies the exact date and time by which an action or response is required. This is typically used to set deadlines for submitting documentation or responding to a chargeback. format: date-time example: '2025-05-30T23:59:59Z' created_datetime: type: string description: >- The created_datetime indicates the exact date and time when the chargeback record was initially created in the system. This timestamp helps in tracking the age of the dispute. format: date-time example: '2025-06-01T23:59:59Z' updated_datetime: type: string description: >- The updated_datetime specifies the most recent date and time when any information related to the chargeback record was modified or updated. This helps in tracking the last activity on the dispute. format: date-time example: '2025-06-01T23:59:59Z' settlement_id: type: string description: ID of the settlement tied to this chargeback example: SETTLEMENT-XYZ-12345 uploaded_proof: type: string description: Link to proof against chargeback example: https://example.com/proofs/chargeback-ABC-67890.pdf comment: type: string description: Additional comments for the chargeback example: >- Customer claims service not rendered. Attached signed delivery confirmation. provider: type: string description: Provider for the chargeback example: Visa arn: type: string description: Acquirer reference number for transaction example: '70010000000000000000001' initiator: type: string description: Initiator of the chargeback example: Cardholder page_info: type: object properties: total: type: integer description: The total number of items available across all pages format: int64 current_page: type: integer description: The current page number being viewed format: int64 total_pages: type: integer description: The total number of pages required to display all items. format: int64 amount: type: number format: decimal description: The payment amount in decimals. example: 12.34 minimum: 0.01 meta: type: object additionalProperties: type: string securitySchemes: bearerAuth: type: http scheme: bearer ````