> ## Documentation Index > Fetch the complete documentation index at: https://docs.salesive.com/llms.txt > Use this file to discover all available pages before exploring further. # List a charge's refunds > The refunds made on one charge. Requires the READ_CHARGES scope. Returns the charge, with `refundedAmount` and `refundStatus`, and every refund made on it. ## OpenAPI ````yaml apps-api/specs/billing.json GET /app-billing/charges/{id}/refunds openapi: 3.1.0 info: title: 'Salesive Apps API: Billing' version: 1.0.0 description: >- Charge the merchant a store is installed for, once or on a schedule. Every endpoint authenticates with an installed-app access token (prefix `app_`). Creating a charge or subscription never moves money: the store owner approves it in the dashboard first. Salesive keeps 5% of every payment and credits the rest to your payout store's wallet. servers: - url: https://api.salesive.com/api/v1 description: Production security: - AppToken: [] paths: /app-billing/charges/{id}/refunds: get: tags: - Charges summary: List a charge's refunds description: >- The charge and its refunds, newest first. Requires `READ_CHARGES`. Authenticate with `Authorization: Bearer app_`. The store is bound to the token server-side, never send a shop id. operationId: listRefunds parameters: - $ref: '#/components/parameters/ChargeId' responses: '200': description: Refunds. content: application/json: schema: allOf: - $ref: '#/components/schemas/EnvelopeBase' - type: object properties: data: type: object properties: charge: $ref: '#/components/schemas/Charge' items: type: array items: $ref: '#/components/schemas/Refund' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' components: parameters: ChargeId: name: id in: path required: true description: The charge id. schema: type: string schemas: EnvelopeBase: type: object description: >- Standard Salesive response envelope. The operation-specific payload is carried in `data`. required: - status - success - message properties: status: type: integer description: HTTP status code, echoed in the body. success: type: boolean description: Whether the request succeeded. message: type: string description: Human-readable result message. Charge: type: object description: >- A payment your app asked the merchant for. A subscription's payments are charges too, with `subscriptionId` set. properties: id: type: string reference: type: string description: Starts with `apc_`. status: type: string enum: - pending - processing - paid - declined - expired - failed description: >- `pending` waits for the merchant. `paid` is final and means your payout store was credited (or, for a test charge, that no money was needed). name: type: string description: type: - string - 'null' amount: type: number description: The price you set, in `currency`. currency: type: string enum: - USD - NGN platformFee: type: number description: Salesive's 5%, in `currency`. netAmount: type: number description: >- What your payout store receives, in `currency`, before conversion to its wallet currency. baseAmount: type: - number - 'null' description: 'On a subscription charge: the base price of the period that starts.' usageAmount: type: - number - 'null' description: >- On a subscription charge: the usage recorded in the period that ended, billed with this charge. refundedAmount: type: number description: >- How much of `amount` has been refunded, in `currency`. A refunded charge keeps `status: paid`. refundStatus: type: string enum: - none - partial - full subscriptionId: type: - string - 'null' periodStart: type: - string - 'null' format: date-time periodEnd: type: - string - 'null' format: date-time test: type: boolean description: True on a development install. No money moves. metadata: type: - object - 'null' description: Whatever you sent, returned unchanged. returnUrl: type: - string - 'null' confirmationUrl: type: - string - 'null' description: Send the merchant here to approve. Present only while `pending`. failureReason: type: - string - 'null' expiresAt: type: - string - 'null' format: date-time paidAt: type: - string - 'null' format: date-time createdAt: type: string format: date-time Refund: type: object description: Money from a paid charge going back to the merchant's wallet. properties: id: type: string reference: type: string description: Starts with `apr_`. chargeId: type: string status: type: string enum: - reserving - processing - completed - failed description: >- `completed` means the merchant's wallet was credited. `failed` means nothing moved; see `failureReason`. amount: type: number description: Refunded, in the charge currency. currency: type: string enum: - USD - NGN platformFeeReturned: type: number description: The share of Salesive's fee given back, in `currency`. netAmountReturned: type: number description: The share of your net amount taken back, in `currency`. merchantAmount: type: - number - 'null' description: What reached the merchant's wallet, in `merchantCurrency`. merchantCurrency: type: - string - 'null' reason: type: - string - 'null' by: type: string enum: - app - admin test: type: boolean failureReason: type: - string - 'null' createdAt: type: string format: date-time completedAt: type: - string - 'null' format: date-time Envelope: allOf: - $ref: '#/components/schemas/EnvelopeBase' - type: object properties: data: description: Operation-specific payload (object, array, or null). responses: Unauthorized: description: Missing or invalid app access token. content: application/json: schema: $ref: '#/components/schemas/Envelope' example: status: 401 success: false message: Authentication required data: null Forbidden: description: The app token is missing the OAuth scope required for this operation. content: application/json: schema: $ref: '#/components/schemas/Envelope' example: status: 403 success: false message: Insufficient scope data: null NotFound: description: >- The resource does not exist or does not belong to the installation's store. content: application/json: schema: $ref: '#/components/schemas/Envelope' example: status: 404 success: false message: Resource not found data: null securitySchemes: AppToken: type: http scheme: bearer description: >- Installed-app access token (prefix app_), issued by the OAuth install flow. The store is bound to the token server-side, never send a shop id. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.