> ## Documentation Index
> Fetch the complete documentation index at: https://docs.golfjoin.co.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# 골프장 목록·검색

> `all=1`이면 전체 골프장과 코스 목록을 돌려줍니다(1시간 캐시). `q`를 주면 이름으로 검색해 최대 20건을 돌려줍니다(코스 목록 없음). 인증이 필요 없습니다.




## OpenAPI

````yaml /api-reference/openapi.yaml get /api/v1/golf-courses
openapi: 3.1.0
info:
  title: 조인성공 파트너 API
  version: '2026-11-02'
  description: 매니저 본인의 권한으로 조인성공 티 매물을 등록·수정·마감합니다.
servers:
  - url: https://golfjoin.co.kr
security:
  - bearerAuth: []
paths:
  /api/v1/golf-courses:
    get:
      tags:
        - 골프장
      summary: 골프장 목록·검색
      description: >
        `all=1`이면 전체 골프장과 코스 목록을 돌려줍니다(1시간 캐시). `q`를 주면 이름으로 검색해 최대 20건을
        돌려줍니다(코스 목록 없음). 인증이 필요 없습니다.
      parameters:
        - name: all
          in: query
          required: false
          schema:
            type: string
            enum:
              - '1'
          description: 전체 목록
        - name: q
          in: query
          required: false
          schema:
            type: string
          description: 골프장 이름 검색어
      responses:
        '200':
          description: 골프장 목록
          content:
            application/json:
              schema:
                type: object
                properties:
                  courses:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          example: 3
                        name:
                          type: string
                          example: 라싸
                        region:
                          type: string
                          example: GYEONGGI_NORTH
                        roadAddress:
                          type:
                            - string
                            - 'null'
                        address:
                          type:
                            - string
                            - 'null'
                        updatedAt:
                          type: string
                          description: all=1 일 때만
                        slug:
                          type: string
                          description: q 검색일 때만
                        fields:
                          type: array
                          description: all=1 일 때만. 골프장 안의 코스
                          items:
                            type: object
                            properties:
                              id:
                                type: integer
                              name:
                                type: string
                                example: 레이크
                              holeCount:
                                type:
                                  - integer
                                  - 'null'
      security: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: OAuth 로그인으로 받은 access token. 1시간 동안 유효합니다.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.