---
title: "Search eligible rate plans and base rates with conflict info."
method: POST
path: "/smart-policies/v1/exceptions/eligible-rates/search"
tags: ["Smart Policy Exceptions"]
---

# Search eligible rate plans and base rates with conflict info.

`POST /smart-policies/v1/exceptions/eligible-rates/search`

## Headers

- `x-property-id` string, required

## Request body

- EligibleRatesRequestSchema
  - `limit` integer — The limit for the number of items to return (max 500)
  - `offset` integer — The offset for the current page of results
  - `startDate` string, date, required — Start date of the date range to filter rate plans.
  - `endDate` string, date, required — End date of the date range to filter rate plans.
  - `intervals` PolicyExceptionIntervalSchema[], required — List of exception intervals for conflict detection.
    - `startDate` string, date, required — Start date of the interval.
    - `endDate` string, date, required — End date of the interval.
    - `day0` boolean — Sunday (day 0) -- apply exception on this day of the week.
    - `day1` boolean — Monday (day 1) -- apply exception on this day of the week.
    - `day2` boolean — Tuesday (day 2) -- apply exception on this day of the week.
    - `day3` boolean — Wednesday (day 3) -- apply exception on this day of the week.
    - `day4` boolean — Thursday (day 4) -- apply exception on this day of the week.
    - `day5` boolean — Friday (day 5) -- apply exception on this day of the week.
    - `day6` boolean — Saturday (day 6) -- apply exception on this day of the week.
  - `exceptionId` string, nullable — Exception ID to exclude from conflict detection (when editing an existing exception).

## Response `200`

Eligible rate plans and base rates with conflict info.

- EligibleRatesResponseSchema
  - `total` integer, required — The total number of items available.
  - `limit` integer, required — The limit for the number of items to return.
  - `offset` integer, required — The offset for the current page of results.
  - `data` EligibleRateItemSchema[], required — Eligible rates for exception creation (rate plans and base rates combined).
    - `name` string, required — Name of the rate plan or room type.
    - `type` string, required — Type of rate: "rate_plan" or "base_rate".
    - `packageId` string, nullable — Package/rate plan ID. Present only when type is "rate_plan".
    - `roomTypeId` string, nullable — Room type ID. Present only when type is "base_rate".
    - `policyId` string, nullable — Smart policy ID associated with this rate plan, if any. Always null for base rates.
    - `conflict` EligibleRateConflictSchema
      - `exceptionId` string, required — ID of the blocking exception.
      - `exceptionName` string, required — Name of the blocking exception.

## Other responses

- `400` — Bad request response.
- `403` — Forbidden response.
- `500` — Internal server error.

---

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