> ## 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 Refunds > Returns a list of all 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 in descending modification date instead. A **refund** represents money returned to a client for a product order. ## OpenAPI ````yaml get /ext/v2/refunds/ openapi: 3.1.0 info: description: '' title: NinjaAPI version: 2.0.0 servers: - url: https://connect.vetcove.com/ security: [] paths: /ext/v2/refunds/: get: tags: - Payment Methods summary: List Refunds description: >- Returns a list of all 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 in descending modification date instead. A **refund** represents money returned to a client for a product order. operationId: refunds_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: Filter refunds by order ID in: query name: order_id required: false schema: anyOf: - type: integer - type: 'null' description: Filter refunds by order ID title: Order Id responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExternalRefundSchemaList' description: OK security: - ExternalAPIAuth: [] components: schemas: ExternalRefundSchemaList: properties: data: description: A single page of data contained within this list. items: $ref: '#/components/schemas/ExternalRefundSchema' 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: ExternalRefundSchemaList type: object ExternalRefundSchema: description: Schema representing a refund for clinic groups (external view) properties: amount: description: Refund amount in cents title: Amount type: integer amount_display: description: Human-readable refund amount (e.g., $10.00) title: Amount Display type: string created: description: The datetime this object was created. format: date-time title: Created type: string currency: anyOf: - $ref: '#/components/schemas/Currency' - const: '' type: string description: The currency of the refund title: Currency id: description: Unique ID of the refund title: Id type: integer is_urgency_fee_refund: description: Indicates if this refund was for an urgency fee title: Is Urgency Fee Refund type: boolean 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 num_order_items: description: Number of order items associated with this refund title: Num Order Items type: integer sponsored_by: anyOf: - type: string - type: 'null' description: Entity sponsoring the refund, if any title: Sponsored By required: - created - modified - id - amount - amount_display - currency - is_urgency_fee_refund - num_order_items - sponsored_by title: ExternalRefundSchema type: object Currency: enum: - USD - CAD title: Currency type: string securitySchemes: ExternalAPIAuth: scheme: bearer type: http ````