---
title: "List Transfers"
method: GET
path: "/ext/v2/transfers/"
tags: ["Payment Methods"]
---

# List Transfers

`GET /ext/v2/transfers/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/transfers/`
- Auth: HTTP bearer

This endpoint is available to Group API Keys only.

Returns a list of all transfers for clinic groups.

A **transfer** represents the movement of funds to a clinic's Stripe account for a completed order.

## 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.
- `order_id` integer, nullable: Filter transfers by order ID
- `payout_ids` integer[], nullable: Filter transfers by payout IDs. Accepts multiple IDs.

## Response `200`

OK

- ExternalTransferSchemaList
  - `data` ExternalTransferSchema[], required: A single page of data contained within this list.
    - `amount` integer, required: Transfer amount in cents
    - `amount_display` string, required: Human-readable transfer amount (e.g., $100.00)
    - `currency` union, required: The currency of the transfer
      - 'USD' | 'CAD'
      - ''
    - `id` integer, required: Unique ID of the transfer
    - `order_id` integer, nullable, required: ID of the order associated with this transfer (if applicable)
    - `payment` string, required: Deprecated. Use payment_id and payment_stripe_id instead.
    - `payment_id` integer, nullable, required: ID of the PaymentIntent used as the source of the transfer
    - `payment_stripe_id` string, nullable, required: Stripe ID of the PaymentIntent used as the source of the transfer
    - `payout_id` integer, nullable, required: ID of the payout associated with this transfer (if applicable)
    - `stripe_account` string, required: Name of the Stripe account receiving the transfer
    - `stripe_id` string, nullable, required: Stripe ID of the transfer (nullable if amount is 0)
  - `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)