Transfers

List Transfers

Changed on

Lists the transfers you can see, sent or received, newest first by default. Optional account filters narrow the results.

get/transfers

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/transfers
  • Auth: HTTP bearer

Query parameters

origin_idstring

Filter to transfers sent from this account.

destination_idstring

Filter to transfers received by this account.

order'created_at' | 'amount'

Sort column. Defaults to created_at.

direction'asc' | 'desc'

Sort direction. Defaults to desc.

created_beforestring

Only transfers created strictly before this ISO 8601 timestamp.

created_afterstring

Only transfers created strictly after this ISO 8601 timestamp.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

Response

transfers listed

Example response

{
  "data": [
    {
      "amount": {
        "amount": "-1234.56",
        "currency": "usd",
        "decimals": 2,
        "display_decimals": 2
      },
      "created_at": "2026-01-01T12:00:00.000Z",
      "destination": {
        "id": "user_xxxxxxxxxxxxxx",
        "name": "Dana Whitfield",
        "object": "user"
      },
      "fee": {
        "amount": "-1234.56",
        "currency": "usd",
        "decimals": 2,
        "display_decimals": 2
      },
      "id": "ctt_xxxxxxxxxxxxxx",
      "metadata": {
        "order_id": "SHINE-1042"
      },
      "notes": "Refund for the rescheduled interior detail",
      "object": "transfer",
      "origin": {
        "id": "biz_xxxxxxxxxxxxxx",
        "logo_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/shine-time-logo",
        "name": "Shine Time Auto Detailing",
        "object": "account"
      },
      "status": "succeeded",
      "tracking_url": "https://whop.com/ctt_xxxxxxxxxxxxxx/"
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

  • 7d2eaa643369Revision changes
    • breaking

      added subschema #2 to the // response property oneOf list for the response status

    • breaking

      the // response's property type changed from number to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      removed the non-success response with the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

  • ff3a76573563Revision changes
    • breaking

      for the query request parameter first, default value was changed from 50 to 20

    • info

      for the query request parameter first, the max was increased from 50.00 to 100.00

    • info

      for the query request parameter last, the max was increased from 50.00 to 100.00