Endpoints

Course Pricing

Course Pricing Information

This endpoint provides detailed pricing information for a specific course across different seasons without checking availability.

Get Course Pricing

Code
 
GET /courses/{courseId}/pricing

Retrieves comprehensive pricing information for a golf course across different seasons and player types.

Path Parameters

Parameter	Type	Description
courseId	string	ID of the course to get pricing for

Query Parameters

Parameter	Type	Description
date	string	Optional specific date to check pricing (YYYY-MM-DD)
currency	string	Currency for price conversion (default: EUR)

Response

Code
 
{
  "courseId": "course_123",
  "courseName": "Marbella Golf Country Club",
  "currency": "EUR",
  "pricingSeasons": [
    {
      "seasonName": "High Season",
      "startDate": "2023-04-01",
      "endDate": "2023-10-31",
      "weekdayPricing": {
        "greenFee": 85.00,
        "twilightFee": 65.00,
        "juniorFee": 42.50
      },
      "weekendPricing": {
        "greenFee": 105.00,
        "twilightFee": 75.00,
        "juniorFee": 52.50
      }
    },
    {
      "seasonName": "Low Season",
      "startDate": "2023-11-01",
      "endDate": "2024-03-31",
      "weekdayPricing": {
        "greenFee": 65.00,
        "twilightFee": 45.00,
        "juniorFee": 32.50
      },
      "weekendPricing": {
        "greenFee": 85.00,
        "twilightFee": 55.00,
        "juniorFee": 42.50
      }
    }
  ],
  "additionalFees": [
    {
      "name": "Golf Cart",
      "price": 40.00,
      "unit": "per_cart",
      "isOptional": true
    },
    {
      "name": "Club Rental",
      "price": 30.00,
      "unit": "per_set",
      "isOptional": true
    }
  ],
  "discounts": [
    {
      "name": "Group Discount",
      "description": "10% off for groups of 8 or more",
      "type": "percentage",
      "value": 10,
      "minPlayers": 8
    },
    {
      "name": "Member Guest Discount",
      "description": "20% off for guests of members",
      "type": "percentage",
      "value": 20,
      "requiresMembershipId": true
    }
  ],
  "pricingNotes": "All prices include VAT. Cancellation fees may apply within 24 hours of tee time."
}

Get Date-Specific Pricing

If you include a specific date in the query parameter, the response will focus on pricing for that particular date:

Code
 
GET /courses/{courseId}/pricing?date=2023-07-15

Response for Specific Date

Code
 
{
  "courseId": "course_123",
  "courseName": "Marbella Golf Country Club",
  "currency": "EUR",
  "date": "2023-07-15",
  "dayType": "weekend",
  "seasonName": "High Season",
  "pricing": {
    "greenFee": 105.00,
    "twilightFee": 75.00,
    "juniorFee": 52.50
  },
  "additionalFees": [
    {
      "name": "Golf Cart",
      "price": 40.00,
      "unit": "per_cart",
      "isOptional": true
    },
    {
      "name": "Club Rental",
      "price": 30.00,
      "unit": "per_set",
      "isOptional": true
    }
  ],
  "specialOffers": [
    {
      "name": "Summer Weekend Special",
      "description": "Early bird discount for tee times before 8:00",
      "price": 90.00,
      "timeRestriction": {
        "startTime": "06:00",
        "endTime": "08:00"
      }
    }
  ],
  "pricingNotes": "All prices include VAT. Cancellation fees may apply within 24 hours of tee time."
}

Currency Conversion

You can request prices in different currencies by using the currency parameter:

Code
 
GET /courses/{courseId}/pricing?currency=USD

The API will convert all prices to the requested currency using current exchange rates.

Pricing Logic

Understanding the pricing structure:

1. Seasons: Courses typically have different pricing for high season, low season, etc.
2. Day types: Weekend prices are often higher than weekday prices
3. Player types: Different rates may apply for adults, juniors, seniors, etc.
4. Time slots: Early morning, standard day, and twilight rates may differ
5. Additional fees: Optional services like golf carts or club rentals
6. Discounts: Special offers based on group size, membership, or booking channel