# Rate Plan Listing

The Rate Plan Listing call is used to retrieve the list of Rate Plans created for existing property. Response data contains information on rate plan's Name, Id, Meal Plan Id and Status.

### <mark style="color:yellow;">Endpoint</mark> <a href="#propertylisting-endpoint.2" id="propertylisting-endpoint.2"></a>

<mark style="color:green;background-color:green;">**`POST`**</mark>&#x20;

<div align="left"><figure><img src="https://958347541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9bn2UcBkeqtqixkl5eF%2Fuploads%2FHpyoT0sTR5VA3RkkSOl8%2FSandbox%20image.png?alt=media&#x26;token=45811e1e-b22d-413a-a355-32135a85258e" alt="" width="56"><figcaption></figcaption></figure></div>

{% code overflow="wrap" %}
```url
https://connect-sandbox.su-api.com/SUAPI/jservice/ratedetails
```
{% endcode %}

***

#### <mark style="color:yellow;">Attributes</mark> <a href="#propertylisting-attributes.2" id="propertylisting-attributes.2"></a>

`hotelid` <mark style="color:orange;">**string (Required)**</mark>

Hotel id for which you want to retrieve the list of rate plans.

{% hint style="info" %}
Maximum 20 characters allowed.
{% endhint %}

### <mark style="color:yellow;">Sample Request</mark>

```json
{
   "hotelid": "new1"
}
```

***

### <mark style="color:yellow;">Response</mark> <a href="#propertylisting-success.2" id="propertylisting-success.2"></a>

#### <mark style="color:green;">**Sample Success Response**</mark>

```json
{
	"rateplans": [{
		"rateplanid": "BAR",
		"rateplanname": "Early Booker Rate",
		"mealplanid": "2",
                "description": "Description of the rate plan",
		"status": "Active"
	}, {
		"rateplanid": "NRF",
		"rateplanname": "Non Refundable Rate",
		"mealplanid": "2",
                "description": "Description of the rate plan",
		"status": "Active"
	}]
}
```

#### <mark style="color:red;">Response Model — No Rate Plan Found</mark> <a href="#propertylisting-responsemodel-norateplanfound" id="propertylisting-responsemodel-norateplanfound"></a>

In this case there is no Rate Plan available for provider based on the parameters provided.&#x20;

#### <mark style="color:red;">**Sample Error Response (939)**</mark>

```json
{
  "Status": "Fail",
  "Errors": {
    "Code": "939",
    "ShortText": "No rates found"
  }
}
```

#### <mark style="color:red;">**Error**</mark>

**Errors Due to Invalid Parameters**

This error 400 will be received if allocated with incorrect Hotel/Client id.

#### <mark style="color:red;">**Sample Error Response (400)**</mark>

```json
{
  "Status": "Fail",
  "Errors": {
    "Code": "400",
    "ShortText": "Invalid HotelCode (new)"
  }
}
```
