--- title: "List transactions" method: POST path: "/transactions" tags: ["Transactions"] --- # List transactions `POST /transactions` ## Request - Base URL: `https://api.wetravel.com/v2` - URL: `https://api.wetravel.com/v2/transactions` - Auth: HTTP bearer Get a list of transactions ## Request body - GetTransactions: Get Transactions Body - `page` integer: Page number - `per_page` integer: Transactions per page, max. 1000 - `filters` object: Filters out transactions - `trip_uuids` string[] - `order_id` integer: The order ID - `currency` 'usd' | 'eur' | 'cad' | 'zar' | 'gbp' | 'aud' | 'nzd' | 'chf' | 'sek' | 'nok' | 'dkk' | 'pln' | 'hkd' | 'mxn': The currency of the transaction - `transaction_type` 'payment' | 'refund' | 'dispute' | 'transfer' | 'payout' | 'instant_payout' | 'wire' | 'card_transfer' | 'adjustment' | 'top_up': The type of the transaction ## Response `200` Get a list of transactions - object - `data` Transaction[] - `uuid` string: The unique global ID of the transaction - `user_id` integer: The unique ID of the user who initiated the transaction - `organizer_id` integer: The unique ID of the organizer who's balance is affected - `vendor_id` integer: The unique ID of the vendor who's balance is affected - `amount` integer: The amount paid excluding all fees - `customer_facing_amount` integer: Total gross amount paid through WeTravel - cc or bank payments - `refunded_amount` integer: Amount refunded to the participant through WeTravel - cc or bank payments - `disputed_amount` integer: Amount disputed to the participant through WeTravel - cc or bank payments - `net_amount` integer: The final amount received by an organizer after deducting all the fees - `currency` string: Currency of the transaction - `transfer_id` string: The unique ID of the transaction based on type - `bank_name` string: Bank's name - `brand` string: Card brand name - `last4` string: Last 4 digits of cc or bank account - `beneficiary_name` string: Beneficiary name of Top Up, Adjustment, Card Transfer, Conversion, Payout/Wire or Supplier Transfers - `beneficiary_email` string: Beneficiary email of Top Up, Payout/Wire, Conversion, or Supplier Transfers - `payout_account_type` string: Payout account type - `status` string: Transaction status - `note` string: Note of the transaction (Purpose of payment of Wire and Supplier Transfers) - `description` string: Description of the transaction - `payment_method` string: Payment method - `payment_id` string: The unique ID of the payment - `order_id` string: The unique ID of the order (booking) - `rebooked_from_order_id` string: The unique ID of the order (booking) which this order was rebooked from - `trip` Trip: Trip object - `title` string: Title of the trip - `all_year` boolean: Whether the trip is recurrent or not - `recurring` boolean: Whether the trip is recurrent or not - `end_date` string, date: End date of the trip in ISO 8601 format, e.g. “2022-08-18” - `location` string: Destination of the trip - `start_date` string, date: Start date of the trip in ISO 8601 format, e.g. “2022-08-12” - `uuid` string: Unique ID of the trip - `trip_id` string: This optional Trip Reference is set by you. It is not visible to your clients. It is only visible to you in your WeTravel dashboard and reporting. - `rebooked_from_trip` Trip: Trip object - `title` string: Title of the trip - `all_year` boolean: Whether the trip is recurrent or not - `recurring` boolean: Whether the trip is recurrent or not - `end_date` string, date: End date of the trip in ISO 8601 format, e.g. “2022-08-18” - `location` string: Destination of the trip - `start_date` string, date: Start date of the trip in ISO 8601 format, e.g. “2022-08-12” - `uuid` string: Unique ID of the trip - `trip_id` string: This optional Trip Reference is set by you. It is not visible to your clients. It is only visible to you in your WeTravel dashboard and reporting. - `participants` Participant[] - `email` string: Email of the participant - `first_name` string: First name of the participant - `last_name` string: Last name of the participant - `packages` Package[] - `name` string: Name of the package - `price` integer: Price of the package - `deposit` integer: Deposit amount for the package - `participants` Participant[] - `email` string: Email of the participant - `first_name` string: First name of the participant - `last_name` string: Last name of the participant - `discount_code` string: discount_code - `buyer` Buyer: Buyer object - `email` string: Email of the buyer - `first_name` string: First name of the buyer - `last_name` string: Last name of the buyer - `type` string: Transaction type - `parent_uuid` string: The unique global ID of the parent transaction - `wetravel_fee` integer: Wetravel fee - `organizer_card_fee` integer: Card fee paid by the organizer - `customer_card_fee` integer: Card fee paid by the customer (buyer) - `organizer_payout_fee` integer: Payout fee paid by the organizer - `created_at` string, date-time: Time at which the transaction was initiated in ISO 8601 format - `updated_at` string, date-time: Time at which the transaction was updated in ISO 8601 format - `running_balance` integer: Running balance - `reference` string: Reference filled in by the user who initiated the transaction - `pagination` Pagination: Pagination object - `total_count` integer: Total number of bookings found in the trip - `page` integer: Current page number where the booking is found - `per_page` integer: How many bookings are per page (default: 20) - `total_pages` integer: Total number of pages - `has_previous` boolean: Whether the previous page is there or not - `has_next` boolean: Whether the next page is there or not --- [API](https://skmtc.dev/wetravel/apis/transactions-api.md) - [All operations](https://skmtc.dev/wetravel/apis/transactions-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wetravel/apis/transactions-api/revisions/0d460712ab0c?raw)