> ## Documentation Index > Fetch the complete documentation index at: https://developer.vetcove.com/llms.txt > Use this file to discover all available pages before exploring further. # List all invoice refunds > Returns a list of all invoice refunds across all clinics in the organization. The refunds are sorted by creation date, with the most recent appearing first. When using modified filters, results are sorted by modification date instead. An invoice refund represents a reversal of a payment made on a clinic invoice. Refunds can be issued as store credit, a credit card reversal, or through an external payment processor. Each refund is tied to a specific invoice payment and records the amount returned to the client. Invoice refunds are never deleted. ## OpenAPI ````yaml get /ext/v2/invoice-refunds/ openapi: 3.1.0 info: description: '' title: NinjaAPI version: 2.0.0 servers: - url: https://connect.vetcove.com/ security: [] paths: /ext/v2/invoice-refunds/: get: tags: - Invoices summary: List all invoice refunds description: >- Returns a list of all invoice refunds across all clinics in the organization. The refunds are sorted by creation date, with the most recent appearing first. When using modified filters, results are sorted by modification date instead. An invoice refund represents a reversal of a payment made on a clinic invoice. Refunds can be issued as store credit, a credit card reversal, or through an external payment processor. Each refund is tied to a specific invoice payment and records the amount returned to the client. Invoice refunds are never deleted. operationId: invoiceRefunds_list parameters: - description: When provided, filters to objects with these IDs. in: query name: ids required: false schema: anyOf: - items: type: integer type: array - type: 'null' description: When provided, filters to objects with these IDs. title: Ids - description: >- A cursor used for pagination. Fetches the page of results ending immediately before the object with the given ID. Cannot be used at the same time as `starting_after`. in: query name: ending_before required: false schema: anyOf: - type: integer - type: 'null' description: >- A cursor used for pagination. Fetches the page of results ending immediately before the object with the given ID. Cannot be used at the same time as `starting_after`. title: Ending Before - description: >- A cursor used for pagination. Fetches the page of results starting immediately after the given ID. Cannot be used at the same time as `ending_before`. in: query name: starting_after required: false schema: anyOf: - type: integer - type: 'null' description: >- A cursor used for pagination. Fetches the page of results starting immediately after the given ID. Cannot be used at the same time as `ending_before`. title: Starting After - description: The maximum number of items to return per page. in: query name: limit required: false schema: default: 10 description: The maximum number of items to return per page. maximum: 100 minimum: 1 title: Limit type: integer - description: >- A cursor token used for pagination. This token contains encoded information about the last seen record in order to continue pagination. Cannot be used with `starting_after` or `ending_before` parameters. in: query name: cursor required: false schema: anyOf: - type: string - type: 'null' description: >- A cursor token used for pagination. This token contains encoded information about the last seen record in order to continue pagination. Cannot be used with `starting_after` or `ending_before` parameters. title: Cursor - description: >- Filters to objects modified on or after this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters. in: query name: modified__gte required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- Filters to objects modified on or after this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters. title: Modified Gte - description: >- Filters to objects modified on or before this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters. in: query name: modified__lte required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- Filters to objects modified on or before this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters. title: Modified Lte - description: When provided, filters to invoice refunds for this clinic. in: query name: clinic_id required: false schema: anyOf: - type: integer - type: 'null' description: When provided, filters to invoice refunds for this clinic. title: Clinic Id - description: When provided, filters to invoice refunds for this clinic client. in: query name: clinic_client_id required: false schema: anyOf: - type: integer - type: 'null' description: When provided, filters to invoice refunds for this clinic client. title: Clinic Client Id - description: When provided, filters to invoice refunds on this invoice. in: query name: invoice_id required: false schema: anyOf: - type: integer - type: 'null' description: When provided, filters to invoice refunds on this invoice. title: Invoice Id responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExternalInvoiceRefundTopLevelSchemaList' description: OK security: - ExternalAPIAuth: [] components: schemas: ExternalInvoiceRefundTopLevelSchemaList: properties: data: description: A single page of data contained within this list. items: $ref: '#/components/schemas/ExternalInvoiceRefundTopLevelSchema' title: Data type: array has_more: default: false description: Whether there are more pages or data in this list. title: Has More type: boolean next_page: description: A URL linking to the next page of this list. title: Next Page type: string type: default: list description: Type of this object. Always `list`. title: Type type: string required: - data - next_page title: ExternalInvoiceRefundTopLevelSchemaList type: object ExternalInvoiceRefundTopLevelSchema: properties: amount: description: The amount refunded, in cents. title: Amount type: integer clinic_client_id: description: The ID of the client (pet parent) on the invoice. title: Clinic Client Id type: integer clinic_id: description: The ID of the clinic that issued the invoice. title: Clinic Id type: integer created: description: The datetime this object was created. format: date-time title: Created type: string currency: $ref: '#/components/schemas/Currency' description: The currency of the refund. id: description: The unique identifier for the invoice refund. title: Id type: integer invoice_id: description: The ID of the invoice this refund is associated with. title: Invoice Id type: integer invoice_payment_id: description: The ID of the invoice payment this refund is against. title: Invoice Payment Id type: integer modified: description: >- The datetime this object was last modified; changes to related entities will not update this field. format: date-time title: Modified type: string refund_type: $ref: '#/components/schemas/RefundType' description: The type of refund (e.g. credit card, store credit, external). required: - created - modified - id - invoice_payment_id - invoice_id - clinic_id - clinic_client_id - amount - refund_type - currency title: ExternalInvoiceRefundTopLevelSchema type: object Currency: enum: - USD - CAD title: Currency type: string RefundType: enum: - CLIENT_CREDIT - STRIPE - EXTERNAL title: RefundType type: string securitySchemes: ExternalAPIAuth: scheme: bearer type: http ````