---
title: "Get Special Offers"
method: GET
path: "/conversations/{conversation_id}/special_offers"
tags: ["Messages"]
---

# Get Special Offers

`GET /conversations/{conversation_id}/special_offers`

List the special offers and pre-approvals that have been sent in a conversation, with their current status. Use the returned `id` to withdraw an offer that is still active. Only Airbnb and booking-site (direct booking) conversations can contain special offers.

## Path parameters

- `conversation_id` string, required

## Response `200`

- object
  - `request_id` string, required — Unique identifier for the request.
  - `error_code` integer, required — Numeric error code representing the status of the response. A value of `200` indicates success. <br> See the [Error Codes](/reference/error-manual#error-codes) section for more information.
  - `error_msg` string, required — Message detailing the status of the response.
  - `data` object, required
    - `special_offers` object[], required — The special offers sent in this conversation, most recent first.
      - `id` string — The id of the special offer on the channel side. Use this id to withdraw the offer.
      - `offer_type` 'special_offer' | 'preapproval' — The kind of offer: a custom-priced special offer, or a pre-approval of the guest's inquiry.
      - `status` string — Current status of the offer, e.g. `active`, `accepted`, `declined`, `expired`, `withdrawn`.
      - `listing_id` string, nullable — The channel listing the offer was sent for (as reported by the channel).
      - `check_in_date` string, date — Check-in date of the offered stay.
      - `check_out_date` string, date — Check-out date of the offered stay.
      - `nights` integer — Number of nights of the offered stay.
      - `number_of_guests` integer — Total number of guests the offer covers.
      - `price` number — Total price of the offered stay, in major currency units.
      - `currency` string, nullable — Currency of the price.
      - `expire_time` string, nullable — When the offer expires, as reported by the channel.
      - `create_time` string, nullable — When the offer was created, as reported by the channel.

---

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