---
title: "Course Group Search by country and region - Returns paginated course groups for a location. United States requests require a region code."
method: POST
path: "/courses/searchCourseGroupsByCountryRegion"
tags: ["CourseSearch"]
---

# Course Group Search by country and region - Returns paginated course groups for a location. United States requests require a region code.

`POST /courses/searchCourseGroupsByCountryRegion`

## Request

- Base URL: `https://api.golfintelligence.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.golfintelligence.com/courses/searchCourseGroupsByCountryRegion`
- Auth: OAuth 2 (password, token URL `/auth/authenticateToken`, scopes: `openid`)

## Request body

- BLLCoursesPublicCourseGroupSearchRequestDto
  - `rows` integer
  - `offset` integer
  - `keywords` string
  - `countryCode` string
  - `regionCode` string
  - `gpsCoordinate` BLLBaseGPSCoordinateDto
    - `latitude` number, double
    - `longitude` number, double
  - `includeUSGACourseIds` boolean

## Response `200`

Success

- BLLCoursesCourseGroupSearchResultsDto
  - `data` BLLCoursesCourseGroupSearchDto[]
    - `isFavorite` boolean
    - `courseCount` integer
    - `teeCount` integer
    - `gpsCount` integer
    - `distance` number, double
    - `facility` BLLCoursesFacilityDto
      - `facilityId` integer
      - `facilityName` string
      - `facilityType` 'SingleCourse' | 'MultipleCourse' | 'SharedCourse'
      - `gpsCoordinate` BLLBaseGPSCoordinateDto
        - `latitude` number, double
        - `longitude` number, double
      - `address` BLLBaseAddressDto
        - `addressId` integer
        - `addressType` 'Physical' | 'Mailing' | 'Billing'
        - `addressName` string
        - `address1` string
        - `address2` string
        - `city` string
        - `region` string
        - `postalCode` string
        - `countryCode` string
      - `isActive` boolean
      - `isPermanantlyClosed` boolean
      - `apiRegionType` 'UnitedStates' | 'Canada' | 'UnitedKingdom' | 'MainlandEurope' | 'AustraliaNewZealand' | 'Asia' | 'MinorCountries'
      - `facilityMembershipType` 'Public' | 'SemiPrivate' | 'Resort' | 'Military' | 'University' | 'Private' | 'Municipal'
      - `contactName` string
      - `contactTitle` string
      - `email` string
      - `website` string
      - `proshop` BLLCoursesProshopDto
        - `hasDrivingRange` boolean
        - `hasPuttingGreen` boolean
        - `hasChippingGreen` boolean
        - `hasPracticeBunker` boolean
        - `hasMotorCart` boolean
        - `hasPullCart` boolean
        - `hasGolfClubRentals` boolean
        - `hasClubFitting` boolean
        - `hasProShop` boolean
        - `hasGolfLessons` boolean
        - `hasCaddieHire` boolean
        - `hasRestaurant` boolean
        - `hasReceptionHall` boolean
        - `hasChangingRoom` boolean
        - `hasLockers` boolean
        - `hasLodgingOnSite` boolean
    - `alternateIds` BLLCoursesCourseGroupAlternateCourseIdDto[]
      - `courseId` integer
      - `courseName` string
      - `shortName` string
      - `courseHoleType` 'EighteenHole' | 'NineHole' | 'Other' | 'TwelveHole'
      - `courseStatusType` 'Active' | 'Inactive'
      - `alternateIdTypeId` integer
      - `alternateIdTypeName` string
      - `alternateId` string
    - `courseGroupId` integer
    - `publicId` string
    - `slug` string
    - `name` string
    - `profileImage` string
    - `coverImage` string
    - `strackaLineId` integer
    - `isActive` boolean
  - `total` integer

## Other responses

- `400`: Bad Request
- `500`: Server Error

---

[API](https://skmtc.dev/golfintelligence/apis/golf-intelligence-api.md) · [All operations](https://skmtc.dev/golfintelligence/apis/golf-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/golfintelligence/apis/golf-intelligence-api/revisions/57d2fc0ccde6?raw)