---
title: "GET /messages"
method: GET
path: "/messages"
tags: ["messages"]
---

# GET /messages

`GET /messages`

Returns a list of messages based on search criteria

## Query parameters

- `OrderBy` string
- `Offset` integer
- `Limit` integer
- `ConversationID` integer
- `UserID` integer
- `ReceiverID` integer
- `SenderID` integer
- `Sentiments` string[]
- `From` string
- `To` string
- `SkipBannedFilter` boolean

## Response `200`

- Message[]
  - `actor_id` integer
  - `archived` boolean
  - `booking` MinBooking
    - `attention_items` AttentionItem[]
      - `data` AttentionItemData
        - `auto_expires` boolean
        - `completed_at` string
        - `confirmation_message` string
        - `conversation_first_message` integer
        - `created_at` string
        - `daily` boolean
        - `description` string
        - `expires_at` string
        - `from` string
        - `group_item_details` Proposal[]
          - `action` string
          - `booking_id` integer
          - `created` string
          - `daily_changes` DailyChange[]
            - `date` string
            - `price` integer
            - `rules` unknown[]
              - …
          - `details` unknown
          - `dry_create` boolean
          - `future_booking` unknown
          - `id` integer
          - `note` string
          - `object_id` integer
          - `object_type` string
          - `owner_acknowledged` string
          - `owner_id` integer
          - `renter_acknowledged` string
          - `renter_dismissed` string
          - `status` string
          - `updated` string
          - `user_notice_events` NoticeResponse[]
            - `guest_acknowledgement_text` string
            - `guest_need_to_acknowledge` boolean
            - `guest_user_text` string
            - `host_acknowledgement_text` string
            - `host_help_url` string
            - `host_need_to_acknowledge` boolean
            - `host_user_text` string
            - `id` integer
            - `name` string
          - `user_notices_acknowledged` integer[]
        - `id` integer
        - `message` string
        - `name` string
        - `price` integer
        - `quantity` integer
        - `rental_amount` integer
        - `to` string
        - `total` integer
      - `is_actionable` boolean
      - `type` string
    - `conversation_id` integer
    - `created` string
    - `details` unknown
    - `display_status` string
    - `display_status_style` string
    - `from` string
    - `id` integer
    - `instant_book` boolean
    - `is_actionable` boolean
    - `items` BookingItem[]
      - `_deleted` boolean — special flag for handling batch update/delete
      - `booking_id` integer
      - `coachnet_item` boolean
      - `consigned_pay_amount` integer
      - `count` integer
      - `created` NullTime — NullTime represents a time.Time that may be null. NullTime implements the sql.Scanner interface so it can be used as a scan destination, similar to sql.NullString.
        - `Time` string, date-time
        - `Valid` boolean
      - `daily` boolean
      - `deferred` boolean
      - `deferred_total` integer, nullable
      - `deleted_at` NullTime — NullTime represents a time.Time that may be null. NullTime implements the sql.Scanner interface so it can be used as a scan destination, similar to sql.NullString.
        - `Time` string, date-time
        - `Valid` boolean
      - `delivery` boolean
      - `description` string
      - `discount_amount` integer
      - `generator` boolean
      - `id` integer
      - `image_url` string
      - `maximum_price` integer, nullable
      - `mileage` boolean
      - `minimum_price` integer, nullable
      - `name` string
      - `original_consigned_pay_pct` number, double — consigned owner support
      - `original_tax_rate_id` integer
      - `other_claim` boolean
      - `outdoorsy_item` boolean
      - `parent_item_id` integer
      - `parent_item_type` string
      - `percent` number, double
      - `percent_type` string
      - `position` integer
      - `premium_amount` integer
      - `premium_total` integer
      - `price` integer
      - `rental_amount` boolean — mutation modifiers
      - `required` boolean
      - `tax_amount` integer
      - `tax_description` string
      - `tax_name` string
      - `tax_rate` number, double
      - `tax_rates` BookingTaxRate[]
        - `booking_id` integer
        - `created` string
        - `deleted` boolean
        - `id` integer
        - `object_id` integer
        - `object_type` string
        - `payable_to` string
        - `source` string
        - `state` string
        - `tax_amount` integer
        - `tax_description` string
        - `tax_name` string
        - `tax_rate` number, double
        - `tax_rate_id` integer
        - `updated` string
        - `zip_code` string
      - `total` integer
      - `updated` NullTime — NullTime represents a time.Time that may be null. NullTime implements the sql.Scanner interface so it can be used as a scan destination, similar to sql.NullString.
        - `Time` string, date-time
        - `Valid` boolean
    - `locale` BookingLocale
      - `base_currency` string
      - `distance_unit` string
    - `owner_approved` boolean
    - `owner_payout` integer
    - `passengers` BookingDriver[]
      - `age_verified` boolean
      - `avatar_url` string
      - `birthdate` string
      - `booking_id` integer
      - `checkr_trust_verified` boolean
      - `checks` BookingDriverCheck[]
        - `arguments` object
        - `country` string
        - `created` string
        - `display_status` string — checkr and sterling specific
        - `external_id` string
        - `failure_reason` string
        - `forced_approval_by` string
        - `forced_approval_reason` string
        - `forced_failure_by` integer
        - `forced_failure_reason` string
        - `id` integer
        - `is_old_enough` boolean
        - `last_created` string
        - `license_state` string
        - `method` string
        - `ofac_sdn_score` number, double
        - `rv_length` string
        - `score` integer — tint specific
        - `status` string
        - `theft_score` integer
        - `validation_id` string
        - `verification_upload_link` string
        - `verified` boolean
      - `driver_check_verified` boolean
      - `driver_verification_status` string
      - `email` string
      - `evident_check_verified` boolean
      - `first_name` string
      - `has_driving_record_check` boolean
      - `id` integer
      - `invite_status` string
      - `last_name` string
      - `legacy_driver` boolean
      - `named_passenger` boolean
      - `owned_by_id` integer
      - `persona_check_verified` boolean
      - `require_evident` boolean
      - `require_persona` boolean
      - `roamly_risk_check_verified` boolean
      - `role` string — attrs from Passenger struct so frontend can treat them the same
      - `show_persona_flow` boolean
      - `tessera_check_verified` boolean
      - `tint_check_verified` boolean
      - `token` string
      - `validation_status` string
      - `verified` boolean
      - `verified_checks_count` integer
    - `rental` RentalSummary
      - `campsite_summary` CampsiteSummary
        - `beds` integer
        - `campground_id` integer
        - `campground_name` string
        - `campground_sitemap_url` string
        - `display_campsite_type` string
        - `display_max_vehicle_length` string
        - `display_site_type` string
        - `is_odn` boolean
        - `rental_id` integer
        - `site_type` string
        - `sleeps` integer
        - `type` string
      - `disallow_movement` boolean
      - `display_type` string
      - `formatted_length` string
      - `id` integer
      - `interior_primary_image_url` string
      - `internal_id` string
      - `location` string
      - `name` string
      - `primary_image_url` string
      - `rental_category` string
      - `sleeps` integer
      - `slug` string
      - `stay_summary` StaySummary
        - `baths` integer
        - `bedrooms` integer
        - `beds` integer
        - `check_in_type` string
        - `display_stay_type` string
        - `location_description` string
        - `max_parking_spaces` integer
        - `parking_onsite` boolean
        - `rental_id` integer
        - `sleeps` integer
        - `type` string
      - `style` string
      - `type` string
    - `renter` UserPartial
      - `avatar_url` string
      - `business_name` string
      - `email` string
      - `first_name` string
      - `id` integer
      - `last_name` string
      - `phone` string
    - `renter_approved` boolean
    - `stage` string
    - `status` string
    - `to` string
    - `total` integer
    - `updated` string
    - `waiver_summary` WaiverSummary
      - `description` string
      - `owner_completed` boolean
      - `owner_terms` string
      - `renter_completed` boolean
      - `renter_confirmation_description` string
      - `renter_confirmation_title` string
      - `renter_terms` string
  - `booking_summary` BookingSummary
    - `from` string
    - `id` integer
    - `to` string
  - `clicked` string
  - `conversation_id` integer
  - `destination_data` RenterDestinationData
    - `region` string
    - `spot_types` string[]
    - `stops` string[]
  - `file_urls` string[]
  - `files` integer[] — DBIntSlice is a []int with database conversion methods
  - `flagged` boolean, nullable
  - `flagged_text` string, nullable
  - `from_email` string, nullable
  - `id` integer
  - `image` string, nullable
  - `latest_status` string, nullable
  - `opened` string
  - `origin` string, nullable
  - `proxy_interaction_id` string, nullable
  - `read` boolean
  - `receiver_id` integer
  - `ref_booking_id` integer
  - `ref_rental_id` integer
  - `rental_summary` unknown
  - `sender_id` integer
  - `sentiment` string
  - `sentiment_confidence` number, double
  - `spam` boolean
  - `system` boolean
  - `template` string
  - `text` string
  - `timestamp` string

## Other responses

- `400` — Invalid input or state means you're bad
- `401` — Unauthorized error
- `404` — Not found error
- `default` — An unknown, unexpected error.

---

[API](https://skmtc.net/outdoorsy/apis/outdoorsy-api-documentation.md) · [All operations](https://skmtc.net/outdoorsy/apis/outdoorsy-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/outdoorsy/outdoorsy-api-documentation/versions/f0cf8f605ea0/schema)