---
title: "List invoice item refunds"
method: GET
path: "/ext/v2/invoices/{invoice_id}/invoice-item-refunds/"
tags: ["Invoices"]
---

# List invoice item refunds

`GET /ext/v2/invoices/{invoice_id}/invoice-item-refunds/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/invoices/{invoice_id}/invoice-item-refunds/`
- Auth: HTTP bearer

Returns a list of refunds applied to individual line items on a specific invoice. The item refunds are sorted by creation date, with the most recent entries appearing first.

## Path parameters

- `invoice_id` integer, required: The ID of the invoice to fetch item refunds for

## Query parameters

- `ids` integer[], nullable: When provided, filters to objects with these IDs.
- `ending_before` integer, nullable: 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`.
- `starting_after` integer, nullable: 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`.
- `limit` integer: The maximum number of items to return per page.

## Response `200`

OK

- InvoiceItemRefundList
  - `data` ExternalInvoiceItemRefundSchema[], required: A single page of data contained within this list.
    - `amount` integer, required: The amount of the refund
    - `created` string, date-time, required: The time at which this item refund was created
    - `id` integer, required: The unique identifier for the item refund
    - `invoice_item_id` integer, required: The ID of the invoice item this refund is for
    - `invoice_refund_id` integer, required: The ID of the invoice refund this item refund belongs to
    - `reason` union, required: The reason for this refund
      - 'Management Discretion' | 'Damaged Product' | 'Out of Stock' | 'Service Not Rendered' | 'Invoice Error': Reasons for refunds (including concepts of "crediting" / "not rendered", which are effectively refunds on the BE)
      - ''
  - `has_more` boolean: Whether there are more pages or data in this list.
  - `next_page` string, required: A URL linking to the next page of this list.
  - `type` string: Type of this object. Always `list`.

---

[API](https://skmtc.dev/vetcove/apis/ninjaapi.md) - [All operations](https://skmtc.dev/vetcove/apis/ninjaapi/llms.txt) - [OpenAPI document](https://skmtc.dev/vetcove/apis/ninjaapi/revisions/4ceaed956e15?raw)
