Transfers

Retrieve Transfer

Changed on

Retrieves a single transfer.

get/transfers/{id}

Request

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

Response

transfer retrieved

created_atstring date-time required

When the transfer was created.

failed_atstring date-time nullable required

Recorded failure time. Null unless the transfer has failed.

failure_codestring nullable required

Machine-readable failure code. Null unless the transfer has failed.

failure_reasonstring nullable required

Failure explanation. Null unless the transfer has failed.

idstring required

Transfer ID.

metadataobject required

Custom metadata attached to the transfer.

notesstring nullable required

Transfer note.

object'transfer' required

The object type.

status'processing' | 'succeeded' | 'failed' required

Current transfer status.

status_changed_atstring date-time nullable required

Recorded time of the current transition. Null when the historical transition time is unknown.

succeeded_atstring date-time nullable required

Recorded success time. Null when unknown.

tracking_urlstring uri required

Tracking page for the transfer. Viewing it requires sign-in and access to the transfer.

Example response

{
  "amount": {
    "amount": "-1234.56",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "created_at": "2026-01-01T12:00:00.000Z",
  "destination": {
    "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"
  },
  "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/"
}

Changes

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • 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

      the response's property type changed from no type to object null for status

    • breaking

      the response's property type changed from no type to object null 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

      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

      removed discriminator from response property for the response status

    • info

      removed discriminator from response property for the response status

    • info

      removed subschema #1: Company subschema #2: User from the response property oneOf list for the response status

    • info

      removed subschema #1: Company subschema #2: User from the response property oneOf list for the response 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

    • 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

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status