---
title: "List trips"
method: GET
path: "/draft_trips"
tags: ["Trips"]
---

# List trips

`GET /draft_trips`

## Request

- Base URL: `https://api.wetravel.com/v2`
- URL: `https://api.wetravel.com/v2/draft_trips`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Get the list of all trips

## Query parameters

- `per_page` integer
- `page` integer
- `exclude_payment_links` boolean

## Response `200`

Successful response

- object
  - `data` Trip[]
    - `uuid` string: Unique ID of the trip
    - `created_at` string, date-time: Time at which the object was created.
    - `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.
    - `url` string: Url of the trip
    - `title` string, required: Title of the trip
    - `destination` string, required: Destination of the trip
    - `start_date` string, required: Start date of the trip in ISO 8601 format, e.g. “2021-05-07”
    - `end_date` string, required: End date of the trip in ISO 8601 format, e.g. “2021-05-07”
    - `group_min` integer, required: Min group size of the trip
    - `group_max` integer, required: Max group size of the trip
    - `currency` string, required: Currency of the trip
    - `participant_list_show_type` 'everyone' | 'participants' | 'only_organizer', required: You can choose to show the names of already booked participants on your booking page. The options are “everyone”, “participants” or “only_organizer” which stand for everyone - everyone can see the participant list on the booking page participants - only already booked participants see the participant list only_organizer - nobody can see the participant list (only the organizer)
    - `welcome_message` string: This welcome message is added to the booking confirmation email and is also shown on the payment confirmation page. This can also contain HTML.
    - `participant_fees` 'credit_card' | 'all' | 'none', required: This setting allows you to choose how the payment fees are handled. The options are: “credit_card” - Bank account payments are free to the participant, but if they choose to pay by credit card, a card fee is added to the price “all” - all fees are paid by the participant “none” - all fees are paid by the organizer
    - `listing_status` 'private' | 'public', required: Whether the trip is “public” or “private”
    - `published` integer: Date and time when the trip was last published. Unpublished trips will return the “published” field empty.
    - `waiting_list_enabled` boolean, required: Whether the trip has a waitlist or not in case it’s sold out.
    - `can_contribute` boolean, required: Whether the participant is allowed to create a contribution / fundraising page after booking this trip.
    - `carbon_offset` CarbonOffset: Carbon Offset Contribution
      - `enabled` boolean, required: Carbon Offset Contribution offered for the trip
      - `percentage` number, required: Carbon Offset Contribution amount as a selected percentage of the trip price
      - `paid_by_participant` boolean, required: Carbon Offset Contribution is paid by participant
  - `pagination` Pagination: Pagination object
    - `total_count` integer: Total number of trips
    - `page` integer: Current page number where the trip is found
    - `per_page` integer: How many trips are per page (default: 25)
    - `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

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/wetravel/apis/trips-builder-api.md) - [All operations](https://skmtc.dev/wetravel/apis/trips-builder-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wetravel/apis/trips-builder-api/revisions/57bdbcf06273?raw)
