> ## Documentation Index > Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt > Use this file to discover all available pages before exploring further. # List Refunds > Get a list of all refunds associated with your account. ## OpenAPI ````yaml get /refunds openapi: 3.1.0 info: title: public description: '' license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0 version: 1.118.3 servers: - url: https://test.dodopayments.com/ description: Test Mode Server Host - url: https://live.dodopayments.com/ description: Live Mode Server Host security: [] tags: - name: Products - name: Payments - name: Subscriptions - name: Addons - name: Customers - name: Refunds - name: Disputes - name: Events - name: License Keys - name: Entitlements - name: Licenses - name: Discounts - name: Meters - name: Credit Entitlements - name: Credit Entitlement Balances - name: Outgoing Webhooks - name: Checkout - name: Webhook Events - name: Payment Connector Webhooks - name: Moderation paths: /refunds: get: tags: - Refunds operationId: list_refunds parameters: - name: created_at_gte in: query description: Get events after this created time required: false schema: type: string format: date-time style: form - name: created_at_lte in: query description: Get events created before this time required: false schema: type: string format: date-time style: form - name: page_size in: query description: Page size default is 10 max is 100 required: false schema: type: integer format: int32 minimum: 0 style: form - name: page_number in: query description: Page number default is 0 required: false schema: type: integer format: int32 minimum: 0 style: form - name: status in: query description: Filter by status required: false schema: type: string enum: - succeeded - failed - pending - review style: form - name: subscription_id in: query description: Filter by subscription id required: false schema: type: string style: form - name: customer_id in: query description: Filter by customer_id required: false schema: type: string style: form responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/GetRefundsListResponse' '500': description: Something went wrong :( security: - API_KEY: [] x-codeSamples: - lang: JavaScript source: |- import DodoPayments from 'dodopayments'; const client = new DodoPayments({ bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted }); // Automatically fetches more pages as needed. for await (const refundListItem of client.refunds.list()) { console.log(refundListItem.business_id); } - lang: Python source: |- import os from dodopayments import DodoPayments client = DodoPayments( bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"), # This is the default and can be omitted ) page = client.refunds.list() page = page.items[0] print(page.business_id) - lang: Go source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/dodopayments/dodopayments-go\"\n\t\"github.com/dodopayments/dodopayments-go/option\"\n)\n\nfunc main() {\n\tclient := dodopayments.NewClient(\n\t\toption.WithBearerToken(\"My Bearer Token\"),\n\t)\n\tpage, err := client.Refunds.List(context.TODO(), dodopayments.RefundListParams{})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", page)\n}\n" - lang: Java source: |- package com.dodopayments.api.example; import com.dodopayments.api.client.DodoPaymentsClient; import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient; import com.dodopayments.api.models.refunds.RefundListPage; import com.dodopayments.api.models.refunds.RefundListParams; public final class Main { private Main() {} public static void main(String[] args) { DodoPaymentsClient client = DodoPaymentsOkHttpClient.fromEnv(); RefundListPage page = client.refunds().list(); } } - lang: Kotlin source: |- package com.dodopayments.api.example import com.dodopayments.api.client.DodoPaymentsClient import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient import com.dodopayments.api.models.refunds.RefundListPage import com.dodopayments.api.models.refunds.RefundListParams fun main() { val client: DodoPaymentsClient = DodoPaymentsOkHttpClient.fromEnv() val page: RefundListPage = client.refunds().list() } - lang: Ruby source: |- require "dodopayments" dodo_payments = Dodopayments::Client.new( bearer_token: "My Bearer Token", environment: "test_mode" # defaults to "live_mode" ) page = dodo_payments.refunds.list puts(page) - lang: PHP source: |- refunds->list( createdAtGte: new \DateTimeImmutable('2019-12-27T18:11:19.117Z'), createdAtLte: new \DateTimeImmutable('2019-12-27T18:11:19.117Z'), customerID: 'customer_id', pageNumber: 0, pageSize: 0, status: 'succeeded', subscriptionID: 'subscription_id', ); var_dump($page); } catch (APIException $e) { echo $e->getMessage(); } - lang: C# source: |- using System; using DodoPayments.Client; using DodoPayments.Client.Models.Refunds; DodoPaymentsClient client = new(); RefundListParams parameters = new(); var page = await client.Refunds.List(parameters); await foreach (var item in page.Paginate()) { Console.WriteLine(item); } - lang: Rust source: |- use dodopayments::Client; #[tokio::main] async fn main() -> dodopayments::Result<()> { let client = Client::from_env()?; let result = client .refunds() .list() .query(serde_json::json!({})) .await?; println!("{result:?}"); Ok(()) } components: schemas: GetRefundsListResponse: type: object required: - items properties: items: type: array items: $ref: '#/components/schemas/RefundListItem' RefundListItem: type: object required: - refund_id - payment_id - business_id - status - created_at - is_partial properties: amount: type: - integer - 'null' format: int32 description: The refunded amount. business_id: type: string description: The unique identifier of the business issuing the refund. created_at: type: string format: date-time description: The timestamp of when the refund was created in UTC. currency: oneOf: - type: 'null' - $ref: '#/components/schemas/Currency' description: >- The currency of the refund, represented as an ISO 4217 currency code. is_partial: type: boolean description: If true the refund is a partial refund network_reference: type: - string - 'null' description: >- The reference number that the card network or the bank gives to the refund. The customer can give this number to their bank to trace the refund. It is null until the reference is available. network_reference_type: oneOf: - type: 'null' - $ref: '#/components/schemas/RefundNetworkReferenceType' description: 'The kind of `network_reference`: ARN, STAN or RRN.' payment_id: type: string description: The unique identifier of the payment associated with the refund. reason: type: - string - 'null' description: The reason provided for the refund, if any. Optional. refund_id: type: string description: The unique identifier of the refund. status: $ref: '#/components/schemas/RefundStatus' description: The current status of the refund. Currency: type: string enum: - AED - ALL - AMD - ANG - AOA - ARS - AUD - AWG - AZN - BAM - BBD - BDT - BGN - BHD - BIF - BMD - BND - BOB - BRL - BSD - BWP - BYN - BZD - CAD - CHF - CLP - CNY - COP - CRC - CUP - CVE - CZK - DJF - DKK - DOP - DZD - EGP - ETB - EUR - FJD - FKP - GBP - GEL - GHS - GIP - GMD - GNF - GTQ - GYD - HKD - HNL - HRK - HTG - HUF - IDR - ILS - INR - IQD - JMD - JOD - JPY - KES - KGS - KHR - KMF - KRW - KWD - KYD - KZT - LAK - LBP - LKR - LRD - LSL - LYD - MAD - MDL - MGA - MKD - MMK - MNT - MOP - MRU - MUR - MVR - MWK - MXN - MYR - MZN - NAD - NGN - NIO - NOK - NPR - NZD - OMR - PAB - PEN - PGK - PHP - PKR - PLN - PYG - QAR - RON - RSD - RUB - RWF - SAR - SBD - SCR - SEK - SGD - SHP - SLE - SLL - SOS - SRD - SSP - STN - SVC - SZL - THB - TND - TOP - TRY - TTD - TWD - TZS - UAH - UGX - USD - UYU - UZS - VES - VND - VUV - WST - XAF - XCD - XOF - XPF - YER - ZAR - ZMW RefundNetworkReferenceType: type: string description: >- The kind of reference number that the card network or the bank gives to a refund. enum: - acquirer_reference_number - system_trace_audit_number - retrieval_reference_number - other RefundStatus: type: string enum: - succeeded - failed - pending - review securitySchemes: API_KEY: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.