# Get rate by ID

Retrieves a specific rate by its unique identifier. Returns basic rate information including rate code, type, and name.

Endpoint: GET /api/v3/rates/{id}
Version: 3.0.9
Security: OAuth2

## Path parameters:

  - `id` (integer, required)
    The ID of the rate to retrieve

## Response 200 fields (application/json):

  - `id` (integer)
    Unique identifier of the rate

  - `rateCode` (string)
    Code of the rate

  - `rateType` (string)
    Type of the rate
    Enum: "DAILY", "WEEKLY", "MONTHLY"

  - `name` (string)
    Name of the rate

  - `shortName` (string)
    Short name of the rate

  - `ratePlan` (object)
    Summary of the rate plan

  - `ratePlan.id` (integer)

  - `ratePlan.title` (string)

  - `ratePlan.description` (string)

  - `ratePlan.vatInclusive` (boolean)

  - `ratePlan.webDescription` (string)

  - `ratePlan.bookingTermsId` (integer)

  - `startDate` (string)
    Start date of the rate

  - `endDate` (string)
    End date of the rate

  - `rateNote` (string)
    Note for the rate

  - `accommodationProduct` (object)
    Product associated with the room stay extra

  - `accommodationProduct.id` (integer)
    Unique identifier of the product
    Example: 1

  - `accommodationProduct.productCode` (string)
    Code of the product
    Example: "PROD-001"

  - `accommodationProduct.name` (string)
    Name of the product
    Example: "Product 1"

  - `depositProduct` (object)
    Product associated with the room stay extra

  - `advancePaymentProduct` (object)
    Product associated with the room stay extra

  - `occupancyCount` (integer)
    Occupancy count for the rate

  - `currency` (object)
    Base currency details of the invoice

  - `currency.id` (integer)
    Unique identifier of the currency
    Example: 1

  - `currency.name` (string)
    Name of the currency
    Example: "US Dollar"

  - `derivedRate` (object)
    Rate summary of the room stay

  - `derivedRateOption` (string)
    Option for the derived rate
    Enum: "FLAT", "PERCENTAGE"

  - `derivedValue` (number)
    Value of the derived rate

  - `bookingType` (object)
    Booking type of the building

  - `bookingType.id` (integer)
    The unique identifier of the booking type

  - `bookingType.name` (string)
    The name of the booking type

  - `bookingType.description` (string)
    The description of the booking type

  - `bookingType.shortCode` (string)
    The short code of the booking type

  - `bookingType.billingType` (string)
    The billing type of the booking
    Enum: "ON_ACCOUNT", "CREDIT_CARD", "CASH_PAYMENT", "BANK_PAYMENT", "VIRTUAL_CARD"

  - `bookingType.emailTo` (string)
    The email recipient of the booking
    Enum: "BOOKING_CONTACT", "BOOKING_GUESTS", "BOOKING_CONTACT_AND_GUESTS"

  - `bookingType.systemBookingType` (boolean)
    Indicates if it is a system booking type

  - `bookingType.systemName` (string)
    The system name of the booking type

  - `bookingType.uuid` (string)
    The unique identifier for the booking type

  - `bookingType.organisationSettings` (object)
    Organisation settings

  - `bookingType.organisationSettings.id` (integer)
    The unique identifier of the organisation settings
    Example: 1

  - `bookingType.organisationSettings.name` (string)
    The name of the organisation
    Example: "Resharmonics"

  - `bookingType.organisationSettings.currency` (object)
    The currency of the organisation

  - `bookingType.organisationSettings.currency.description` (string)
    Description of the currency

  - `bookingType.organisationSettings.currency.symbol` (string)
    Symbol of the currency

  - `bookingType.organisationSettings.currency.exchangeRate` (number)
    Exchange rate of the currency

  - `bookingType.organisationSettings.currency.baseRate` (number)
    Base rate of the currency

  - `bookingType.organisationSettings.currency.unit` (string)
    Unit of the currency

  - `bookingType.organisationSettings.currency.autoUpdate` (boolean)
    Indicates if the currency is auto-updated

  - `bookingType.organisationSettings.currency.primaryCurrency` (boolean)
    Indicates if this is the primary currency

  - `bookingType.organisationSettings.currency.htmlSafeSymbol` (string)
    HTML safe symbol of the currency

  - `bookingType.organisationSettings.country` (object)
    Data Transfer Object representing a Country entity in the Property Management System (PMS).

  - `bookingType.organisationSettings.country.id` (integer)
    Unique identifier of the country

  - `bookingType.organisationSettings.country.name` (string, required)
    Name of the country

  - `bookingType.organisationSettings.country.sortOrder` (integer, required)
    Sort order of the country

  - `bookingType.organisationSettings.country.countryCodeAlpha2` (string, required)
    Alpha-2 country code

  - `bookingType.organisationSettings.country.countryCodeAlpha3` (string, required)
    Alpha-3 country code

  - `bookingType.organisationSettings.country.countryCodeNumeric` (string, required)
    Numeric country code

  - `leadTime` (integer)
    Lead time for the rate

  - `closedToArrivalAfter` (integer)
    Closed to arrival after

  - `derivedDefaultMinLos` (number)
    Default minimum length of stay for the derived rate